browser-use /web-ui

🖥️ Run AI Agent in your browser.

★ 16,655⑂ 2,755👁 122⑃ 240● 444▤ 9
PythonMITCreated 2025-01-02
Download: WebUI or VibeSurf? cdb-use is all you need 🚀WebUI-3.0.0 ↓3.0.02025-08-31
+2
Daily
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_USER

Top issues

Latest release

WebUI or VibeSurf? cdb-use is all you need 🚀 v3.0.0 2025-08-31
Hey 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON