web-ui

browser-useMIT活跃维护

在浏览器里直接跑 AI Agent 的 Web 界面,让 browser-use 的浏览器自动化能力开箱即用,不用自己搭前端就能可视化操作和调试。

🖥️ Run AI Agent in your browser.

v3.0.0发布于 2025-08-31 14:16 UTC16,646star2,759fork同步于 2026-11-10 05:24 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/browser-use/web-ui.git && cd web-ui
uv venv --python 3.11
uv pip install -r requirements.txt
playwright install --with-deps
cp .env.example .env
python webui.py --ip 127.0.0.1 --port 7788
硬件要求按 README 说明

README 未说明显存或 GPU 要求;本地安装需 Python 3.11 环境,Docker 方式需 Docker 与 Docker Compose,ARM64 机器需指定 TARGETPLATFORM=linux/arm64

支持 Apple Silicon有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于 Gradio 的 browser-use 网页界面,让 AI 代理在浏览器里自动操作网站

在浏览器里直接跑 AI Agent 的 Web 界面,让 browser-use 的浏览器自动化能力开箱即用,不用自己搭前端就能可视化操作和调试。

核心能力

  • 用 Gradio 搭建可视化界面,操作 browser-use 代理
  • 集成 OpenAI、Anthropic、DeepSeek、Ollama 等多种 LLM
  • 支持接入本机 Chrome,复用登录状态免重复认证
  • 可保持浏览器会话在任务间不关闭,查看完整交互历史
  • 提供 Docker 部署并附带 VNC 观看浏览器操作

容易踩的坑

需先在 .env 中填入各 LLM 的 API Key,否则无法调用模型;使用自有浏览器时须关闭所有 Chrome 窗口并用非 Chrome 浏览器打开 WebUI;Docker 方式默认 VNC 密码为 youvncpassword,需通过 VNC_PASSWORD 修改

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v3.0.0
  1. v3.0.0WebUI or VibeSurf? cdb-use is all you need 🚀最新正式版2025-08-31 · 2025-08-31 14:16 UTC

    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 browser operations and agent results simultaneously - it just wasn't cutting it for me.

    So I said "screw it" and rebuilt the whole thing as a Chrome extension with a completely different architecture. Meet VibeSurf 🏄‍♂️

    VibeSurf keeps all the webui goodies you love (custom LLMs, local browser, MCP support, etc.) but adds some seriously cool upgrades:

    🔥 What makes VibeSurf awesome:

    • Latest browser-use 0.6+ support - We ditched Playwright and went all-in on cdp-use (hence the title!)

    • Parallel multi-agent magic - This is my favorite feature! Run multiple agents simultaneously in the same browser, each in their own tab. Perfect for wide research with agents working in isolation while dramatically boosting efficiency and reducing resource usage.

    • Beyond automation - Sure, it does browser automation, but VibeSurf also handles deep research, intelligent crawling, content summarization, and more exploratory tasks.

    • Dead simple setup - Just run uv pip install vibesurf, then type vibesurf in your terminal. Boom! It fires up your local browser with the extension loaded, giving you an interface that feels like it's actually part of your browser.

    https://github.com/user-attachments/assets/70b8ea0c-b641-4885-8426-0454a0f7cf38

    So... WebUI or VibeSurf? What's your vibe? Feel free to slide into my DMs! 😎

    P.S. - If you're as excited about open-source AI browsing as I am, give it a star! ⭐

  2. v2.0.0💥 Browser-Use + MCP: Unleashing Agent Power Beyond the Browser! 🚀2025-05-01 · 2025-05-01 05:56 UTC
    查看更新说明

    Hey everyone,

    Get ready for a game-changing update! We're absolutely thrilled to announce the latest version of browser-use webui, packed with features that dramatically expand the capabilities of your AI agents. This release marks a significant milestone, especially with the deep integration of browser-use and MCP!

    Here's what's new and exciting:

    1. Full Compatibility with browser-use 0.1.48: We've updated our integration to be fully compatible with browser-use version 0.1.48. This means you can leverage all the latest features, improvements, and stability enhancements from the core browser-use library right out of the box. Stay on the cutting edge of browser automation! ✨

    2. Browser-use Meets MCP Servers: A New Era of Agent Power! 🥁 With the introduction of MCP server support, we've unlocked a universe of possibilities for your agents!

      • What does this mean? browser-use can now seamlessly interact with external tools and services defined as MCP servers. Think of it as giving your browser agent access to a whole new set of limbs and senses outside of the web page!
      • Go Beyond Browsing: Your browser-use agent can now run desktop commands (like file operations or launching applications via tools like @wonderwhy-er/desktop-commander), interact with local services, connect to databases, run scripts, and so much more. The potential is truly vast!
      • Simple Configuration: Getting started with MCP servers is straightforward. Simply define your desired servers in your configuration file using a structure like this JSON(Claude desktop MCP json):
      {
        "mcpServers": {
          "desktop-commander": {
            "command": "npx",
            "args": [
              "-y",
              "@wonderwhy-er/desktop-commander"
            ]
          }
        }
      }
      

    https://github.com/user-attachments/assets/c347bbc1-9d65-45ef-88bc-6eefed14ba43

    1. Brand New Web UI for Agent Interaction:
    • Introducing our shiny new Web UI! 🌐 Interact with your browser-use agent in a conversational manner directly from your browser. This UI allows you to:
    • Provide human intervention, when needed – whether it's solving a CAPTCHA, making a complex decision, or guiding the agent through an unexpected situation. It's seamless human-agent collaboration!
    1. Enhanced DeepResearch Agent (MCP Enabled!): We've also significantly upgraded our deepresearch agent! 🧠 This new version is more powerful and efficient at gathering and synthesizing information. And yes, it also fully supports the new MCP system, enabling it to use external tools for research tasks.

    How to Update:

    uv pip install -r requirements.txt
    python webui.py
    

    Thanks to all the contributors!

    Thank you for your continued support! Happy building! 🎉

  3. v1.7Security Update & UI Enhancements!2025-03-29 · 2025-03-29 03:37 UTC
    查看更新说明

    Hello everyone,

    We're happy to announce the new release of browser-use-webui! 🎉 This update brings support for new models, several improvements, and an important security fix.

    • Hotfix some issues: open multiple tabs, etc.

    Here's what's new:

    • ✅ WebUI Compatibility: Updated the WebUI to be compatible with the latest browser-use==0.1.40. Remember uv pip install -r requirements.txt.
    • 🐛 Bug Fixes: Squashed several bugs to improve stability and performance.
    • 🎨 UI Optimization: Refreshed the WebUI for a cleaner, more intuitive, and aesthetically pleasing user experience.
    • 🤖 New Model Support:
      • Gemini: Added support for gemini-2.5-pro-exp-03-25. Simply input the model name directly.
      • DeepSeek: Added support for DeepSeek-V3-0324. Select the deepseek-chat option and remember to uncheck use_vision for this model.
    • ⚙️ Improved Config Handling: Reworked the WebUI config saving and loading mechanism. It's now more robust and adaptive to user configurations.

    🚨 Important Security Update: 🚨

    • We have fixed a critical security vulnerability related to loading WebUI configurations using pickle. Loading untrusted pickle files can potentially lead to arbitrary code execution.
    • To mitigate this risk, we have migrated to using json for saving and loading WebUI settings. This is a much safer standard.
    • We strongly urge all users to update to v1.7 or later immediately to protect themselves. Please avoid using older versions that load configurations via pickle. Your settings should automatically migrate where possible, but backing up your old config is always wise.

    Thanks to @Wh1teZe , refer to https://github.com/browser-use/web-ui/issues/451

  4. v1.6DeepResearch Lands on Browser-Use Web UI, with Collaborative Agents! 🤖🤝📚2025-02-06 · 2025-02-06 12:16 UTC
    查看更新说明

    Thanks to @vvincent1234. Now, you can seamlessly leverage DeepResearch's advanced capabilities in WebUI.

    Important Notes:

    • DeepResearch feature is currently in alpha version and under rapid development. Stay updated by watching this repository.
    • DeepResearch consumes relatively many tokens. Please reduce Max Search Iteration and Max Query per Iteration according to your needs. These two represent the maximum number of search iterations and the number of simultaneous queries per search iteration respectively.

    What's New?

    2025/02/09

    1. Hotfix some bugs
    2. Split extracted content and limit max content lenght

    2025/02/07

    1. Added a stop button, allowing you to stop your research at any time.
    2. Use your own browser. However, using your own browser currently only supports single searches per iteration.
    3. Currently recommending the gemini-2.0-flash-thinking-exp-01-21 model. This is because excessively long extracted content can sometimes cause API call errors.

    Key benefits of this integration include:

    • DeepResearch within Your Browser: Access all DeepResearch features directly in your own browser – no more need for external search APIs! 🌐
    • Collaborative Agents: Harness the power of multiple AI agents working in concert. 🤖🤝
    • Indexed Information Sources: Easily save and access all referenced articles for future reference, promoting transparency and ensuring the reliability of your research. 📚

    How to Get Started:

    1. Update Your Code: Pull the latest version to experience the new features. ⬆️
    2. Choose a Powerful LLM: To fully utilize DeepResearch, select a reasoning-capable LLM such as gemini-2.0-flash-thinking-exp-01-21, deepseek-r1, or o3-mini. 🧠
    3. Enter Your Research Topic: Navigate to the DeepResearch section within the Browser-Use Web UI and input your research theme. 📝
    4. Configure Parameters: Adjust the max_search_iteration_input and max_query_per_iter_input according to the complexity of your research. ⚙️
    5. Run Deep Research: Click the "run_deep_research" button and wait for your professional research report to be generated. ⏳

    Demo: https://www.youtube.com/watch?v=sguzGWuiRT8

  5. v1.4🚀 Local DeepSeek-r1 Power with Ollama! 2025-01-28 · 2025-01-28 12:52 UTC
    查看更新说明

    Hey everyone,

    We've just rolled out a new release packed with awesome updates:

    1. Browser-Use Upgrade: We're now fully compatible with the latest browser-use version 0.1.29! 🎉
    2. Local Ollama Integration: Get ready for completely local and private AI with support for the incredible deepseek-r1 model via Ollama! 🏠

    Before You Dive In:

    • Update Code: Don't forget to git pull to grab the latest code changes.
    • Reinstall Dependencies: Run pip install -r requirements.txt to ensure all your dependencies are up to date.

    Important Notes on deepseek-r1:

    • Model Size Matters: We've found that deepseek-r1:14b and larger models work exceptionally well! Smaller models may not provide the best experience, so we recommend sticking with the larger options. 🤔

    How to Get Started with Ollama and deepseek-r1:

    1. Install Ollama: Head over to ollama and download/install Ollama on your system. 💻
    2. Run deepseek-r1: Open your terminal and run the command: ollama run deepseek-r1:14b (or a larger model if you prefer).
    3. WebUI Setup: Launch the WebUI following the instructions. Here's a crucial step: Uncheck "Use Vision" and set "Max Actions per Step" to 1. ✅
    4. Enjoy! You're now all set to experience the power of local deepseek-r1. Have fun! 🥳

    Happy Chinese New Year! 🏮

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    GitHub stars Discord Documentation WarmShao

    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
    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):

    uv venv --python 3.11
    

    Activate the virtual environment:

    • Windows (Command Prompt):
    .venv\Scripts\activate
    
    • Windows (PowerShell):
    .\.venv\Scripts\Activate.ps1
    
    • macOS/Linux:
    source .venv/bin/activate
    
    Step 3: Install Dependencies

    Install Python packages:

    uv pip install -r requirements.txt
    

    Install Browsers in playwright.

    playwright install --with-deps
    

    Or you can install specific browsers by running:

    playwright install chromium --with-deps
    
    Step 4: Configure Environment
    1. Create a copy of the example environment file:
    • Windows (Command Prompt):
    copy .env.example .env
    
    • macOS/Linux/Windows (PowerShell):
    cp .env.example .env
    
    1. 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:
      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
           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
           BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
           BROWSER_USER_DATA="/Users/YourUsername/Library/Application Support/Google/Chrome"
          
      • 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
    Step 1: Clone the Repository
    git clone https://github.com/browser-use/web-ui.git
    cd web-ui
    
    Step 2: Configure Environment
    1. Create a copy of the example environment file:
    • Windows (Command Prompt):
    copy .env.example .env
    
    • macOS/Linux/Windows (PowerShell):
    cp .env.example .env
    
    1. Open .env in your preferred text editor and add your API keys and other settings
    Step 3: Docker Build and Run
    docker compose up --build
    

    For ARM64 systems (e.g., Apple Silicon Macs), please run follow command:

    TARGETPLATFORM=linux/arm64 docker compose up --build
    
    Step 4: Enjoy the web-ui and vnc
    • Web-UI: Open http://localhost:7788 in your browser
    • VNC Viewer (for watching browser interactions): Open http://localhost:6080/vnc.html
      • Default VNC password: "youvncpassword"
      • Can be changed by setting VNC_PASSWORD in your .env file

    Changelog

    • 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.