web-ui

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

该项目基于 browser-use 的基础构建，旨在使网站对 AI 代理可访问。

我们想正式感谢 WarmShao 对本项目的贡献。

WebUI： 构建在 Gradio 之上，支持大部分 browser-use 功能。该用户界面旨在用户友好，并可轻松与浏览器代理互动。

扩展的 LLM 支持： 我们已集成对各种大型语言模型（LLM）的支持，包括：Google、OpenAI、Azure OpenAI、Anthropic、DeepSeek、Ollama 等。我们计划未来增加对更多模型的支持。

自定义浏览器支持： 你可以在我们的工具中使用自己的浏览器，免去重新登录网站或处理其他身份验证问题的麻烦。该功能还支持高清屏幕录制。

持久浏览器会话： 你可以选择在 AI 任务之间保持浏览器窗口打开，以便查看 AI 互动的完整历史和状态。

安装指南

选项 1：本地安装

阅读 快速入门指南 或按照以下步骤开始。

步骤 1：克隆仓库

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

步骤 2：设置 Python 环境

我们建议使用 uv 来管理 Python 环境。

使用 uv（推荐）：

uv venv --python 3.11

激活虚拟环境：

• Windows（命令提示符）：

  .venv\Scripts\activate

• Windows（PowerShell）：

  .\.venv\Scripts\Activate.ps1

• macOS/Linux：

  source .venv/bin/activate

步骤 3：安装依赖项

安装 Python 包：

uv pip install -r requirements.txt

在 Playwright 中安装浏览器。

playwright install --with-deps

或者你可以通过运行以下命令来安装特定的浏览器：

playwright install chromium --with-deps

第4步：配置环境

1. 创建示例环境文件的副本：
   • Windows（命令提示符）：

     copy .env.example .env

   • macOS/Linux/Windows (PowerShell):

     cp .env.example .env

2. 在您喜欢的文本编辑器中打开 .env 文件，并添加您的 API 密钥和其他设置

第 5 步：享受 Web 界面

1. 运行 WebUI：

   python webui.py --ip 127.0.0.1 --port 7788

2. 访问 WebUI： 打开您的网页浏览器并导航到 http://127.0.0.1:7788。
3. 使用您自己的浏览器（可选）：
   • 将 BROWSER_PATH 设置为您浏览器的可执行文件路径，将 BROWSER_USER_DATA 设置为您浏览器的用户数据目录。如果想使用本地用户数据，请将 BROWSER_USER_DATA 保持为空。
     • 窗口

       BROWSER_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
       BROWSER_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\User Data"

       注意：在 Windows 系统上，将 YourUsername 替换为你实际的 Windows 用户名。

     • 麦金塔

       BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
       BROWSER_USER_DATA="/Users/YourUsername/Library/Application Support/Google/Chrome"

   • 关闭所有 Chrome 窗口
   • 在非 Chrome 浏览器中打开 WebUI，例如 Firefox 或 Edge。这很重要，因为在运行代理时，持久的浏览器上下文将使用 Chrome 数据。
   • 在浏览器设置中勾选“使用自己的浏览器”选项。

选项 2：Docker 安装

先决条件

• 已安装 Docker 和 Docker Compose
  • Docker Desktop（适用于 Windows/macOS）
  • Docker Engine 和 Docker Compose（适用于 Linux）

步骤 1：克隆仓库

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

步骤 2：配置环境

1. 创建示例环境文件的副本：
   • Windows（命令提示符）：

     copy .env.example .env

   • macOS/Linux/Windows (PowerShell):

     cp .env.example .env

2. 在你喜欢的文本编辑器中打开 .env 并添加你的 API 密钥和其他设置

步骤 3：Docker 构建和运行

docker compose up --build

对于 ARM64 系统（例如，Apple Silicon Mac），请运行以下命令：

TARGETPLATFORM=linux/arm64 docker compose up --build

第4步：享受网页界面和VNC

• 网页界面：在浏览器中打开 http://localhost:7788
• VNC 查看器（用于观察浏览器交互）：打开 http://localhost:6080/vnc.html
  • 默认 VNC 密码：“youvncpassword”
  • 可以通过在 .env 文件中设置 VNC_PASSWORD 来更改

更新日志

• 2025/01/26： 感谢 @vvincent1234。现在 browser-use-webui 可以与 DeepSeek-r1 结合参与深度思考！
• 2025/01/10： 感谢 @casistack。现在我们有了 Docker 设置选项，并且支持在任务之间保持浏览器开启。视频教程演示。
• 2025/01/06： 感谢 @richard-devbot。发布了全新且设计良好的 WebUI。视频教程演示