browser-use / web-ui

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 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 Step 2: Set Up Python Environment We recommend using uv for managing the Python environment. Using uv (recommended): Activate the virtual environment: • Windows (Command Prompt): • Windows (PowerShell): • macOS/Linux: Step 3: Install Dependencies Install Python packages: Install Browsers in playwright. Or you can install specific browsers by running: Step 4: Configure Environment • Create a copy of the example environment file: • Windows (Command Prompt): • macOS/Linux/Windows (PowerShell): • Open in your preferred text editor and add your API keys and other settings Step 5: Enjoy the web-ui • **Run the WebUI:** • **Access the WebUI:** Open your web browser and navigate to . • **Using Your Own Browser(Optional):** • Set to the executable path of your browser and to the user data directory of your browser. Leave empty if you want to use local user data. • Windows > Note: Replace with your actual Windows username for Windows systems. • Mac • 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. Option 2: Docker Installation Prerequisites • Docker and Docker Compose installed • Docker Desktop (For Windows/macOS) • Docker Engine and Docker Compose (For Linux) Step 1: Clone the Repository Step 2: Configure Environment • Create a copy of the example environment file: • Windows (Command Prompt): • macOS/Linux/Windows (PowerShell): • Open in your preferred text editor and add your API keys and other settings Step 3: Docker Build and Run For ARM64 systems (e.g., Apple Silicon Macs), please run follow command: Step 4: Enjoy the web-ui and vnc • Web-UI: Open in your browser • VNC Viewer (for watching browser interactions): Open • Default VNC password: "youvncpassword" • Can be changed by setting in your file Changelog • [x] **2025/01/26:** Thanks to @vvincent1234. Now browser-use-webui can combine with DeepSeek-r1 to engage in deep thinking! • [x] **2025/01/10:** Thanks to @casistack. Now we have Docker Setup option and also Support keep browser open between tasks.Video tutorial demo. • [x] **2025/01/06:** Thanks to @richard-devbot. A New and Well-Designed WebUI is released. Video tutorial demo.