browser-use/web-ui

本项目基于 browser-use 构建，旨在让 AI Agent 能够轻松访问并操作网页。

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

WebUI: 基于 Gradio 构建，支持 browser-use 的绝大多数功能。该 UI 设计友好，方便用户与浏览器 Agent 进行交互。

扩展的 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 Key 及其他设置。

第 5 步：使用 web-ui

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 留空。
     • Windows

        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 用户名。

     • Mac

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

   • 关闭所有 Chrome 窗口。
   • 在非 Chrome 浏览器（如 Firefox 或 Edge）中打开 WebUI。这一点很重要，因为持久化浏览器上下文在运行 Agent 时会占用 Chrome 数据。
   • 在浏览器设置中勾选 "Use Own Browser"（使用自己的浏览器）选项。

选项 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 Key 及其他设置。

第 3 步：Docker 构建与运行

docker compose up --build

针对 ARM64 系统：