+2
日增长
16,655
stars
2,755
forks
122
watchers
240
prs
444
issues
9
releases
README
This project builds upon the foundation of the browser-use, which is designed to make websites accessible for AI agents.
We would like to officially thank WarmShao for his contribution to this project.
WebUI: is built on Gradio and supports most of browser-use functionalities. This UI is designed to be user-friendly and enables easy interaction with the browser agent.
Expanded LLM Support: We've integrated support for various Large Language Models (LLMs), including: Google, OpenAI, Azure OpenAI, Anthropic, DeepSeek, Ollama etc. And we plan to add support for even more models in the future.
Custom Browser Support: You can use your own browser with our tool, eliminating the need to re-login to sites or deal with other authentication challenges. This feature also supports high-definition screen recording.
Persistent Browser Sessions: You can choose to keep the browser window open between AI tasks, allowing you to see the complete history and state of AI interactions.
Your browser does not support playing this video!
Installation Guide
Option 1: Local Installation
Read the quickstart guide or follow the steps below to get started.
Step 1: Clone the Repository
bash
git clone https://github.com/browser-use/web-ui.git
cd web-ui
Step 2: Set Up Python Environment
We recommend using uv for managing the Python environment.
Using uv (recommended):
bash
uv venv --python 3.11
Activate the virtual environment:
- Windows (Command Prompt):
cmd
.venv\Scripts\activate
- Windows (PowerShell):
powershell
.\.venv\Scripts\Activate.ps1
- macOS/Linux:
bash
source .venv/bin/activate
Step 3: Install Dependencies
Install Python packages:
bash
uv pip install -r requirements.txt
Install Browsers in playwright.
bash
playwright install --with-deps
Or you can install specific browsers by running:
bash
playwright install chromium --with-deps
Step 4: Configure Environment
1. Create a copy of the example environment file:
- Windows (Command Prompt):
bash
copy .env.example .env
- macOS/Linux/Windows (PowerShell):
bash
cp .env.example .env
2. Open .env in your preferred text editor and add your API keys and other settings
Step 5: Enjoy the web-ui
1. Run the WebUI:
bash
python webui.py --ip 127.0.0.1 --port 7788
2. Access the WebUI: Open your web browser and navigate to http://127.0.0.1:7788.
3. Using Your Own Browser(Optional):
- Set BROWSER_PATH to the executable path of your browser and BROWSER_USER_DATA to the user data directory of your browser. Leave BROWSER_USER_DATA empty if you want to use local user data.
- Windows
env
BROWSER_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
BROWSER_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\User Data"
Note: Replace YourUsername with your actual Windows username for Windows systems.
- Mac
env
BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
BROWSER_USERTop issues
#146[Errno 111] Connection refused24 comments · 2025-01-24#300Own chrome browser not running20 comments · 2025-02-15#29do it need gpu ? long time not to generate result17 comments · 2025-01-07#267click Run Agent error15 comments · 2025-02-10#471How can I use my chrome?14 comments · 2025-04-03#335How to let WebUi to use my own Chrome instead of the blue Selenium13 comments · 2025-02-23#195Local deepseek deepseek-r1:14b, working but took very long time13 comments · 2025-01-29#94Agent Error when providing prompt13 comments · 2025-01-12
Latest release
WebUI or VibeSurf? cdb-use is all you need 🚀 v3.0.0 2025-08-31Hey everyone! 👋 I've been seeing tons of AI browsers popping up lately - Comet, Dia, you name it. But here's the thing: they're all closed-source! As someone who's always wanted to build an open-source agentic AI browser that lets users customize their LLMs and agents while keeping personal data safe and local, I got inspired to take action. Initially, I thought about turning browser-use webui into a full agentic AI browser (or at least a solid browser assistant). But honestly? The Gradio-based webui felt... clunky. Switching windows to submit new tasks, not being able to watch the brows