链载Ai

标题: 斩获11.8k星！像人类一样使用浏览器，轻松实现浏览器自动化! [打印本页]

---

作者: 链载Ai    时间: 5 小时前
标题: 斩获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：克隆仓库

gitclonehttps://github.com/browser-use/web-ui.gitcdweb-ui

第二步：设置 Python 环境

我们推荐使用 uv 来管理 Python 环境。

使用 uv（推荐）：

uvvenv--python3.11

激活虚拟环境：

• Windows（命令提示符）：

.venv\Scripts\activate

• Windows (PowerShell):
  

.\.venv\Scripts\Activate.ps1

• macOS/Linux:

source.venv/bin/activate

步骤 3：安装依赖

安装 Python 包：

uvpipinstall-rrequirements.txt

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

playwrightinstall--with-depschromium

安装所有浏览器：

playwrightinstall

第 4 步：配置环境

1. 
   创建示例环境文件的副本：

• Windows (命令提示符):

copy.env.example.env

• macOS/Linux/Windows (PowerShell):

cp.env.example.env

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

选项 2：Docker 安装

前提条件

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

安装步骤

1. 1 克隆仓库：

gitclonehttps://github.com/browser-use/web-ui.gitcdweb-ui

1. 2 创建并配置环境文件：

• Windows (命令提示符):

copy.env.example.env

• macOS/Linux/Windows (PowerShell):

cp.env.example.env

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

1. 3 使用 Docker 运行:

#Buildandstartthecontainerwithdefaultsettings(browserclosesafterAItasks)dockercomposeup--build

#Orrunwithpersistentbrowser(browserstaysopenbetweenAItasks)CHROME_PERSISTENT_SESSION=truedockercomposeup--build

1. 4 访问应用:

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

使用说明

本地设置

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

pythonwebui.py--ip127.0.0.1--port7788

1. 2WebUI 选项：

• 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:\ProgramFiles\Google\Chrome\Application\chrome.exe"CHROME_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\UserData"

  Mac
• 
  
• 
  
• CHROME_PATH="/Applications/GoogleChrome.app/Contents/MacOS/GoogleChrome"CHROME_USER_DATA="/Users/YourUsername/Library/ApplicationSupport/Google/Chrome"

  
  
• 
  
• 
  
• 关闭所有 Chrome 窗口
• 在非 Chrome 浏览器中打开 WebUI，例如 Firefox 或 Edge。这很重要，因为持久的浏览器上下文在运行代理时会使用 Chrome 的数据。
• 在浏览器设置中检查“使用自己的浏览器”选项。
• 保持浏览器打开（可选）：
• 在.env文件中设置CHROME_PERSISTENT_SESSION=true。

配置

1. 1 环境变量：

• 所有配置都通过.env文件完成
• 可用的环境变量：
# LLM API KeysOPENAI_API_KEY=your_key_hereANTHROPIC_API_KEY=your_key_hereGOOGLE_API_KEY=your_key_here
# Browser SettingsCHROME_PERSISTENT_SESSION=true # Set to true to keep browser open between AI tasksRESOLUTION=1920x1080x24    # Custom resolution format: WIDTHxHEIGHTxDEPTHRESOLUTION_WIDTH=1920     # Custom width in pixelsRESOLUTION_HEIGHT=1080    # Custom height in pixels
# VNC SettingsVNC_PASSWORD=your_vnc_password # Optional, defaults to "vncpassword"

1. 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 browserCHROME_PERSISTENT_SESSION=truedocker compose up -d
# Start with default mode (browser closes after tasks)docker compose up -d
# View logsdocker compose logs -f
# Stop the containerdocker compose down

---

欢迎光临 链载Ai (https://www.lianzai.com/)

Powered by Discuz! X3.5