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

web-ui
browser-useMIT活跃维护在浏览器里直接跑 AI Agent 的 Web 界面,让 browser-use 的浏览器自动化能力开箱即用,不用自己搭前端就能可视化操作和调试。
🖥️ Run AI Agent in your browser.
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 7788README 未说明显存或 GPU 要求;本地安装需 Python 3.11 环境,Docker 方式需 Docker 与 Docker Compose,ARM64 机器需指定 TARGETPLATFORM=linux/arm64
基于 Gradio 的 browser-use 网页界面,让 AI 代理在浏览器里自动操作网站
在浏览器里直接跑 AI Agent 的 Web 界面,让 browser-use 的浏览器自动化能力开箱即用,不用自己搭前端就能可视化操作和调试。
核心能力
- 用 Gradio 搭建可视化界面,操作 browser-use 代理
- 集成 OpenAI、Anthropic、DeepSeek、Ollama 等多种 LLM
- 支持接入本机 Chrome,复用登录状态免重复认证
- 可保持浏览器会话在任务间不关闭,查看完整交互历史
- 提供 Docker 部署并附带 VNC 观看浏览器操作
容易踩的坑
- 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 typevibesurfin 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! ⭐
-
- 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-useand MCP!Here's what's new and exciting:
-
Full Compatibility with
browser-use0.1.48: We've updated our integration to be fully compatible withbrowser-useversion 0.1.48. This means you can leverage all the latest features, improvements, and stability enhancements from the corebrowser-uselibrary right out of the box. Stay on the cutting edge of browser automation! ✨ -
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-usecan 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-useagent 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" ] } } } - What does this mean?
https://github.com/user-attachments/assets/c347bbc1-9d65-45ef-88bc-6eefed14ba43
- Brand New Web UI for Agent Interaction:
- Introducing our shiny new Web UI! 🌐 Interact with your
browser-useagent 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!
- Enhanced DeepResearch Agent (MCP Enabled!): We've also significantly upgraded our
deepresearchagent! 🧠 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.pyThanks to all the contributors!
Thank you for your continued support! Happy building! 🎉
-
- 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. Rememberuv 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 thedeepseek-chatoption and remember to uncheckuse_visionfor this model.
- Gemini: Added support for
- ⚙️ 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 untrustedpicklefiles can potentially lead to arbitrary code execution. - To mitigate this risk, we have migrated to using
jsonfor 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
- 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
- Hotfix some bugs
- Split extracted content and limit max content lenght
2025/02/07
- Added a stop button, allowing you to stop your research at any time.
- Use your own browser. However, using your own browser currently only supports single searches per iteration.
- 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:
- Update Your Code: Pull the latest version to experience the new features. ⬆️
- 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, oro3-mini. 🧠 - Enter Your Research Topic: Navigate to the DeepResearch section within the Browser-Use Web UI and input your research theme. 📝
- Configure Parameters: Adjust the
max_search_iteration_inputandmax_query_per_iter_inputaccording to the complexity of your research. ⚙️ - Run Deep Research: Click the "run_deep_research" button and wait for your professional research report to be generated. ⏳
- 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:
- Browser-Use Upgrade: We're now fully compatible with the latest
browser-useversion 0.1.29! 🎉 - Local Ollama Integration: Get ready for completely local and private AI with support for the incredible
deepseek-r1model via Ollama! 🏠
Before You Dive In:
- Update Code: Don't forget to
git pullto grab the latest code changes. - Reinstall Dependencies: Run
pip install -r requirements.txtto ensure all your dependencies are up to date.
Important Notes on
deepseek-r1:- Model Size Matters: We've found that
deepseek-r1:14band 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:- Install Ollama: Head over to ollama and download/install Ollama on your system. 💻
- Run
deepseek-r1: Open your terminal and run the command:ollama run deepseek-r1:14b(or a larger model if you prefer). - WebUI Setup: Launch the WebUI following the instructions. Here's a crucial step: Uncheck "Use Vision" and set "Max Actions per Step" to 1. ✅
- Enjoy! You're now all set to experience the power of local
deepseek-r1. Have fun! 🥳
Happy Chinese New Year! 🏮
- Browser-Use Upgrade: We're now fully compatible with the latest
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
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
- 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
Step 5: Enjoy the web-ui
- 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
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
git clone https://github.com/browser-use/web-ui.git
cd web-ui
Step 2: Configure Environment
- 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
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: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
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.