Web-UI 本地部署指南 (Windows)

本文档将指导您如何在 Windows 系统上一步步安装和运行 browser-use/web-ui 项目。

准备工作

在开始之前，请确保您的系统满足以下条件：

Windows 操作系统：本指南基于 PowerShell 命令，主要适用于 Windows 环境。
Git：确保您已安装 Git 并配置好环境。
Python 3.11：确保您已安装 Python 3.11。uv 工具会使用系统中已安装的 Python 版本来创建虚拟环境。

安装步骤

1. 克隆项目仓库

首先，使用 Git 克隆项目的代码仓库到您的本地计算机，并进入项目目录。

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

2. 安装 uv (Python 包管理工具)

uv 是一个速度极快的 Python 包管理工具。我们使用 PowerShell 执行以下命令来安装它。

uv官方地址(Win)：https://docs.astral.sh/uv/getting-started/installation/

# uv安装指令
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

注意：如果这是您第一次在 PowerShell 中运行脚本，ExecutionPolicy ByPass 参数是为了临时绕过执行策略限制。

3. 创建并激活虚拟环境

为了隔离项目依赖，我们使用 uv 创建一个独立的 Python 3.11 虚拟环境。

uv venv --python 3.11  #该命令会在当前目录下创建一个名为 .venv 的文件夹。
.venv\Scripts\activate  #接下来，您需要激活这个环境,成功激活后，您会在命令行提示符前看到 (.venv) 标志。

4. 安装项目依赖

在激活的虚拟环境中，使用 uv 读取 requirements.txt 文件，并安装所有必需的 Python 包。

uv pip install -r requirements.txt

5. 安装 Playwright 浏览器驱动

Playwright 需要对应的浏览器驱动来执行自动化任务。运行以下命令进行安装。

playwright install

6. 配置环境变量

项目需要一个 .env 文件来存储配置。通过复制示例文件 .env.example 来创建一个新的.env配置文件。

copy .env.example .env

您可以根据需要用文本编辑器打开并修改 .env 文件中的配置项。以下是示例：

OPENAI_ENDPOINT=https://openrouter.ai/api/v1
OPENAI_API_KEY=sk-or-v1-6ea8d8edd1b6xxxxxxxxxxxx4f0axxx435b70xxxxxxxxxxx0f720b

ANTHROPIC_API_KEY=
ANTHROPIC_ENDPOINT=https://api.anthropic.com

GOOGLE_API_KEY=

AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_API_VERSION=2025-01-01-preview

DEEPSEEK_ENDPOINT=https://api.deepseek.com
DEEPSEEK_API_KEY=

MISTRAL_API_KEY=
MISTRAL_ENDPOINT=https://api.mistral.ai/v1

OLLAMA_ENDPOINT=http://localhost:11434

ALIBABA_ENDPOINT=https://dashscope.aliyuncs.com/compatible-mode/v1
ALIBABA_API_KEY=

MOONSHOT_ENDPOINT=https://api.moonshot.cn/v1
MOONSHOT_API_KEY=

UNBOUND_ENDPOINT=https://api.getunbound.ai
UNBOUND_API_KEY=

SiliconFLOW_ENDPOINT=https://api.siliconflow.cn/v1/
SiliconFLOW_API_KEY=

IBM_ENDPOINT=https://us-south.ml.cloud.ibm.com
IBM_API_KEY=
IBM_PROJECT_ID=

# Set to false to disable anonymized telemetry
ANONYMIZED_TELEMETRY=false

# LogLevel: Set to debug to enable verbose logging, set to result to get results only. Available: result | debug | info
BROWSER_USE_LOGGING_LEVEL=info

# Chrome settings
CHROME_PATH=C:\Program Files\Google\Chrome\Application\chrome.exe
CHROME_USER_DATA=
CHROME_DEBUGGING_PORT=9222
CHROME_DEBUGGING_HOST=localhost
# Set to true to keep browser open between AI tasks
CHROME_PERSISTENT_SESSION=false
CHROME_CDP=
# Display settings
# Format: WIDTHxHEIGHTxDEPTH
RESOLUTION=1920x1080x24
# Width in pixels
RESOLUTION_WIDTH=1920
# Height in pixels
RESOLUTION_HEIGHT=1080

# VNC settings
VNC_PASSWORD=youvncpassword

运行与访问

所有准备工作完成后，执行以下命令来启动 Web UI 服务。

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

服务启动后，终端会显示运行日志。此时，在您的浏览器中打开以下地址即可访问 Web UI：

http://127.0.0.1:7788

AI自动化操作浏览器神器browser-use