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：本地安装

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

第一步：克隆仓库

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

第二步：设置 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

第三步：安装依赖

安装 Python 包：

uv pip install -r requirements.txt

安装 Playwright 浏览器：

playwright install --with-deps

或者您可以运行以下命令安装指定的浏览器：

playwright install chromium --with-deps

第四步：配置环境

1. 复制环境示例文件：

• Windows (命令提示符):

copy .env.example .env

• macOS/Linux/Windows (PowerShell):

cp .env.example .env

2. 使用您偏好的文本编辑器打开 .env 文件，并添加您的 API Key 及其他设置。

第五步：使用 WebUI

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)

第一步：克隆仓库

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

第二步：配置环境

1. 复制环境示例文件：

• Windows (命令提示符):

copy .env.example .env

• macOS/Linux/Windows (PowerShell):

cp .env.example .env

2. 使用您偏好的文本编辑器打开 .env 文件，并添加您的 API Key 及其他设置。

第三步：构建并运行 Docker

docker compose up --build

针对 ARM64 系统：