web-ui

环境要求

• Python 3.11（README 推荐用 uv 创建虚拟环境）
• uv（推荐的 Python 环境与包管理工具）
• Playwright 浏览器内核及系统依赖（playwright install --with-deps）
• Docker 与 docker compose（仅选择 Docker 方式时需要）

安装与启动步骤

1. 1克隆项目仓库

   把 web-ui 仓库下载到本地，之后的创建环境、装依赖都在这个目录里执行。

   git clone https://github.com/browser-use/web-ui.git

   复制

2. 2创建虚拟环境

   README 推荐用 uv 管理 Python 环境，这里显式指定 Python 3.11 创建 .venv。

   uv venv --python 3.11

   复制

3. 3激活虚拟环境

   macOS/Linux 用下面的命令；Windows 命令提示符用 .venv\Scripts\activate，PowerShell 用 .\.venv\Scripts\Activate.ps1。

   source .venv/bin/activate

   复制

4. 4安装 Python 依赖

   在已激活的虚拟环境中，按 requirements.txt 一次性安装项目所需 Python 包。

   uv pip install -r requirements.txt

   复制

5. 5安装浏览器内核

   用 Playwright 安装浏览器及系统依赖；想少下载可只装 chromium（见常见问题）。

   playwright install --with-deps

   复制

6. 6Docker 方式启动

   不想配本地环境可直接用 Docker；Apple Silicon 等 ARM64 机器需加 TARGETPLATFORM 变量。

   docker compose up --build

   复制

关键配置

如何确认成功

启动后 Gradio 会输出本地访问地址，用浏览器打开该地址能看到 WebUI 界面即表示成功。

常见问题

注意事项

• README 推荐使用 Python 3.11 并用 uv 管理虚拟环境。
• 支持使用自己的浏览器，可免去重复登录网站和处理认证的麻烦。
• 可开启持久化浏览器会话，在多次 AI 任务之间保持浏览器窗口与历史状态。
• 已集成 Google、OpenAI、Azure OpenAI、Anthropic、DeepSeek、Ollama 等多种大模型。