browser-use:AI 驱动的浏览器自动化神器——安装与配置详解

一、安装 python

browser-use 是基于 python 语言开发的，因此本文将以 python 的方式来详细说明如何进行安装配置。

Browser Use requires Python 3.11 or higher.

官方文档中 browser-use 要求 python 的版本 >= 3.11

1.1 MacOS 系统上安装 python

MacOS 系统上安装 python 的方式有很多种，本文将以 Homebrew 为例来演示

• 打开终端窗口，检查是否已安装好 Homebrew

brew --version

• 如果没有安装，可以根据下面的命令进行安装（国内镜像源安装）

# 使用中科大镜像的安装脚本(自动配置仓库地址)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 选项说明：
    输入 '1' 选择 '中科大源'
    按提示完成安装，脚本会自动处理镜像配置

• 通过 Homebrew 安装 python3

brew install python

说明： 此处先不用关注 python 版本，后面创建 python 虚拟环境时会指定 3.11 版本的 python。

• 安装完成后， 检查 python 版本

pytnon3 --version

1.2 Windows 系统上安装 python

• 访问 Python 官方下载页面，下载最新的 Python 3 安装包

https://www.python.org/downloads/

• 运行安装包，并确保勾选了 "Add Python to PATH "选项

• 安装完成后，打开命令提示符，检查 Python 版本：

python --version

二、安装 Git

2.1 MacOS 安装

• 通过 Homebrew 安装

brew install git

• 安装完成后，检查 Git 版本

git --version

2.2 Windows 安装

• Git 官网下载软件包

https://git-scm.com/downloads/win

• 下载完成后双击exe文件，直接打开安装，点击Next一路安装后即可，正常情况下使用git默认的配置即可

• 安装过程中有几个流程需要注意和配置的地方，如下

additional icons：图标组件，创建桌面快捷方式

Windows Explorer integration：可以右键选择使用Git Bash和Git GUI两种方式的客户端。

Git LFS：Git是否支持大文件

Associate相关的两项是关联git配置文件和shell文件，分别用于显示文本编辑器样式等功能和关联Bash命令执行脚本文件。

• 选择在Git初始化时默认的分支名字

Let Git Decide,git仓库初始化的时候默认的分支名为master

Override the default branch name for new repositories, 你可以选择自定义Git仓库初始化时的默认分支，根据各团队的分支命名方式来定，如果有这个需求的话选择这项，在下面的输入框中输入默认的分支名称，然后点击Next进入下一步

• 选择默认的终端工具

第一个只使用git bash作为git终端功能

第二个配置可以让Git在其他终端工具中也可以被使用，例如Windows的PowerShell

第三个是上面二者同时配置，但是会将windows中的find.exe和sort.exe工具覆盖

• 选择换行格式

第一项在提交时将windows格式的换行转为unix格式的换行。

第二个是提交时不管什么格式的，一律转换为unix格式的换行。

第三个不进行转换 默认选择第一个即可，这样做的好处是有利于跨系统平台的兼容和统一，例如在Windows和在Linux下的格式都是一样的，不需要再手动做转换，不然会很麻烦

• 完成安装，检查版本

git --version

三、Python 虚拟环境管理

3.1 更新 pip

python -m pip install --upgrade pip

3.2 安装 uv

pip install uv

3.3 创建虚拟环境

cd ~
mkdir browser-use
cd ~\browser-use
uv venv --python 3.11

3.4 激活虚拟环境

source .venv/bin/activate    # MacOS 

.venv\Scripts\activate         # Windows 

四、安装 Docker

• 下载 Docker Desktop

https://www.docker.com/products/docker-desktop/

• 安装 Docker Desktop

• 启动 Docker Desktop

首次启动需要更新 wsl

• 验证是否安装成功

docker run hello-world

五、本地安装 browser-use

https://kkgithub.com/browser-use/web-ui

5.1 拉取代码

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

5.2 启动 python 虚拟环境

.venv\Scripts\activate     # Windows

source .venv/bin/activate    # MacOS

5.3 安装 python 依赖

uv pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

5.4 安装 playwright

playwright install --with-deps

# 指定运行的浏览器
playwright install chromium --with-deps

5.5 配置环境

• 复制 .env.example 到 .env

copy .env.example .env    # Windows

cp .env.example .env    # MacOS

• 配置相关变量

DEEPSEEK_ENDPOINT=https://api.deepseek.com
DEEPSEEK_API_KEY=<DeepSeek API-KEY>

#set default LLM
DEFAULT_LLM=deepseek

# 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

# Browser settings
BROWSER_PATH="C:\Users\<username>\AppData\Local\Google\Chrome\Application\chrome.exe"
 BROWSER_USER_DATA="C:\Users\<username>\AppData\Local\Google\Chrome\User Data"
BROWSER_DEBUGGING_PORT=9222
BROWSER_DEBUGGING_HOST=localhost

# Set to true to keep browser open between AI tasks
KEEP_BROWSER_OPEN=true
USE_OWN_BROWSER=false
BROWSER_CDP=

  # Display settings
# Format: WIDTHxHEIGHTxDEPTH
RESOLUTION=1920x1080x24

# Width in pixels
RESOLUTION_WIDTH=1920

# Height in pixels
RESOLUTION_HEIGHT=1080

# VNC settings
VNC_PASSWORD=youvncpassword

5.6 运行 web-ui

• 启动 web-ui 服务

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

• 访问 web-ui

http://127.0.0.1:7788

六、Docker 安装

6.1 拉取代码

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

6.2 配置环境

• 复制 .env.example 到 .env

copy .env.example .env    # Windows

cp .env.example .env    # MacOS

• 配置相关变量

DEEPSEEK_ENDPOINT=https://api.deepseek.com
DEEPSEEK_API_KEY=<DeepSeek API-KEY>

#set default LLM
DEFAULT_LLM=deepseek

# 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

# Browser settings
BROWSER_PATH="C:\Users\<username>\AppData\Local\Google\Chrome\Application\chrome.exe"
 BROWSER_USER_DATA="C:\Users\<username>\AppData\Local\Google\Chrome\User Data"
BROWSER_DEBUGGING_PORT=9222
BROWSER_DEBUGGING_HOST=localhost

# Set to true to keep browser open between AI tasks
KEEP_BROWSER_OPEN=true
USE_OWN_BROWSER=false
BROWSER_CDP=

  # Display settings
# Format: WIDTHxHEIGHTxDEPTH
RESOLUTION=1920x1080x24

# Width in pixels
RESOLUTION_WIDTH=1920

# Height in pixels
RESOLUTION_HEIGHT=1080

# VNC settings
VNC_PASSWORD=youvncpassword

6.3 启动 docker

docker compose up --build

TARGETPLATFORM=linux/arm64 docker compose up --build   # arm64 系统

6.4 运行 web-ui 和 vnc

• web-ui

http://localhost:7788

• vnc

http://localhost:6080/vnc.html

至此 browser-use 的安装配置就已完成，本文介绍了2种安装方式，可以根据自己的需求任选其一即可。

下一篇我们将继续介绍 browser-use 的多种使用方式，欢迎大家一样讨论。