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.
bu-webui-demo.mp4
Read the quickstart guide or follow the steps below to get started.
git clone https://github.com/browser-use/web-ui.git
cd web-uiWe recommend using uv for managing the Python environment.
Using uv (recommended):
uv venv --python 3.11Activate the virtual environment:
- Windows (Command Prompt):
.venv\Scripts\activate- Windows (PowerShell):
.\.venv\Scripts\Activate.ps1- macOS/Linux:
source .venv/bin/activateInstall Python packages:
uv pip install -r requirements.txtInstall Browsers in playwright.
playwright install --with-depsOr you can install specific browsers by running:
playwright install chromium --with-deps- Create a copy of the example environment file:
- Windows (Command Prompt):
copy .env.example .env- macOS/Linux/Windows (PowerShell):
cp .env.example .env- Open
.envin your preferred text editor and add your API keys and other settings
- Run the WebUI:
python webui.py --ip 127.0.0.1 --port 7788
- Access the WebUI: Open your web browser and navigate to
http://127.0.0.1:7788. - Using Your Own Browser(Optional):
- Set
BROWSER_PATHto the executable path of your browser andBROWSER_USER_DATAto the user data directory of your browser. LeaveBROWSER_USER_DATAempty if you want to use local user data.- Windows
BROWSER_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe" BROWSER_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\User Data"
Note: Replace
YourUsernamewith your actual Windows username for Windows systems. - Mac
BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" BROWSER_USER_DATA="/Users/YourUsername/Library/Application Support/Google/Chrome"
- Windows
- Close all Chrome windows
- Open the WebUI in a non-Chrome browser, such as Firefox or Edge. This is important because the persistent browser context will use the Chrome data when running the agent.
- Check the "Use Own Browser" option within the Browser Settings.
- Set
- Docker and Docker Compose installed
- Docker Desktop (For Windows/macOS)
- Docker Engine and Docker Compose (For Linux)
git clone https://github.com/browser-use/web-ui.git
cd web-ui- Create a copy of the example environment file:
- Windows (Command Prompt):
copy .env.example .env- macOS/Linux/Windows (PowerShell):
cp .env.example .env- Open
.envin your preferred text editor and add your API keys and other settings
docker compose up --buildFor ARM64 systems (e.g., Apple Silicon Macs), please run follow command:
TARGETPLATFORM=linux/arm64 docker compose up --build- Web-UI: Open
http://localhost:7788in your browser - VNC Viewer (for watching browser interactions): Open
http://localhost:6080/vnc.html- Default VNC password: "youvncpassword"
- Can be changed by setting
VNC_PASSWORDin your.envfile
- 2025/01/26: Thanks to @vvincent1234. Now browser-use-webui can combine with DeepSeek-r1 to engage in deep thinking!
- 2025/01/10: Thanks to @casistack. Now we have Docker Setup option and also Support keep browser open between tasks.Video tutorial demo.
- 2025/01/06: Thanks to @richard-devbot. A New and Well-Designed WebUI is released. Video tutorial demo.