斩获11.8k星！像人类一样使用浏览器，轻松实现浏览器自动化!

项目简介

本项目建立在 browser-use 的基础上，browser-use 旨在使网站对 AI 代理可访问。

WebUI：基于 Gradio 构建，支持大部browser-use 功能。此用户界面设计得非常用户友好，并允许轻松与浏览器代理进行交互。

扩展支持 LLM：我们已集成对各种大型语言模型(LLMs)的支持，包括：谷歌、OpenAI、Azure OpenAI、Anthropic、DeepSeek、Ollama 等。我们计划未来添加更多模型的支持。

自定义浏览器支持：您可以使用我们的工具使用自己的浏览器，无需重新登录网站或处理其他认证挑战。此功能还支持高清屏幕录制。

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

安装指南

前提条件

Python 3.11 或更高版本
Git（用于克隆仓库）

选项 1：本地安装

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

步骤 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

步骤 3：安装依赖

安装 Python 包：

uv pip install -r requirements.txt

在 Playwright 中安装浏览器：您可以通过运行以下命令来安装特定浏览器：

playwright install --with-deps chromium

安装所有浏览器：

playwright install

第 4 步：配置环境

创建示例环境文件的副本：
- Windows (命令提示符):

copy .env.example .env

macOS/Linux/Windows (PowerShell):

cp .env.example .env

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

选项 2：Docker 安装

前提条件

已安装 Docker 和 Docker Compose
- Docker Desktop（适用于 Windows/macOS）
- Docker 引擎和 Docker Compose（适用于 Linux）

安装步骤

1 克隆仓库：

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

2 创建并配置环境文件：
- Windows (命令提示符):

copy .env.example .env

macOS/Linux/Windows (PowerShell):

cp .env.example .env

使用您喜欢的文本编辑器编辑 .env 并添加您的 API 密钥

3 使用 Docker 运行:

# Build and start the container with default settings (browser closes after AI tasks) docker compose up --build

# Or run with persistent browser (browser stays open between AI tasks) CHROME_PERSISTENT_SESSION=true docker compose up --build

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

使用说明

本地设置

1 运行 WebUI：完成上述安装步骤后，启动应用程序：

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

2 WebUI 选项：
- Default: 具有平衡设计的标准主题。
- Soft: 柔和、淡雅的色彩方案，提供轻松的观看体验。
- Monochrome: 以最小化色彩为特点的灰度主题，简洁且专注。
- Glass: 现代感十足，半透明的时尚设计。
- Origin:经典复古风格，唤起怀旧情怀。
- Citrus: 充满活力的柑橘色调，明亮且清新。
- Ocean ：蓝色海洋风格，带来宁静的体验。
- --ip: 绑定 WebUI 的 IP 地址。默认为 `127.0.0.1` 。
- --port: 绑定 WebUI 的端口号。默认为 `7788` 。
- --theme ：用户界面主题。默认为 `Ocean` 。
- --dark-mode: 启用暗黑模式界面。
3 访问 WebUI：打开您的网页浏览器并导航到 http://127.0.0.1:7788 。
4 使用您自己的浏览器（可选）：
- 将 CHROME_PATH 设置为您的浏览器可执行文件路径，将 CHROME_USER_DATA 设置为您的浏览器用户数据目录。如果想要使用本地用户数据，请将 CHROME_USER_DATA 留空。
- Windows
- CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe" CHROME_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\User Data"
  Mac
- CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" CHROME_USER_DATA="/Users/YourUsername/Library/Application Support/Google/Chrome"
- 关闭所有 Chrome 窗口
- 在非 Chrome 浏览器中打开 WebUI，例如 Firefox 或 Edge。这很重要，因为持久的浏览器上下文在运行代理时会使用 Chrome 的数据。
- 在浏览器设置中检查“使用自己的浏览器”选项。
保持浏览器打开（可选）：
- 在 .env 文件中设置 CHROME_PERSISTENT_SESSION=true 。

配置

1 环境变量：
- 所有配置都通过 .env 文件完成
- 可用的环境变量：

# LLM API Keys OPENAI_API_KEY=your_key_here ANTHROPIC_API_KEY=your_key_here GOOGLE_API_KEY=your_key_here # Browser Settings CHROME_PERSISTENT_SESSION=true # Set to true to keep browser open between AI tasks RESOLUTION=1920x1080x24 # Custom resolution format: WIDTHxHEIGHTxDEPTH RESOLUTION_WIDTH=1920 # Custom width in pixels RESOLUTION_HEIGHT=1080 # Custom height in pixels # VNC Settings VNC_PASSWORD=your_vnc_password # Optional, defaults to "vncpassword"

2 平台支持：
- 支持 AMD64 和 ARM64 架构
- 对于 ARM64 系统（例如，苹果硅 Mac），容器将自动使用适当的镜像
3 浏览器持久化模式：
- 浏览器在 AI 任务之间保持开启状态
- 维护历史和状态
- 允许查看之前的 AI 交互
- 在 .env 文件中设置或通过启动容器时环境变量设置
- 浏览器每次执行 AI 任务后打开和关闭
- 每次交互都保持干净状态
- 资源使用量更低
- 默认模式（CHROME_PERSISTENT_SESSION=false）:
- 持久模式（CHROME_PERSISTENT_SESSION=true）:
4 查看浏览器交互：
- 访问 noVNC 查看器 http://localhost:6080/vnc.html
- 输入 VNC 密码（默认：”vncpassword” 或你在 VNC_PASSWORD 中设置的值）
- 直接在端口 5900 上提供 VNC 访问（映射到容器端口 5901）
- 您现在可以实时查看所有浏览器交互
5 容器管理：

# Start with persistent browser CHROME_PERSISTENT_SESSION=true docker compose up -d # Start with default mode (browser closes after tasks) docker compose up -d # View logs docker compose logs -f # Stop the container docker compose down