能力标签
浏览器飞行员
🛠
AI工具

浏览器飞行员

基于 Python · 开源 AI 工具,GitHub 社区精选
英文名:browser-pilot
⭐ 30 Stars 🍴 2 Forks 💻 Python 📄 Apache-2.0 🏷 AI 7.5分
7.5AI 综合评分
浏览器自动化AI代理工作流DockerSelenium
✦ AI Skill Hub 推荐

经 AI Skill Hub 精选评估,浏览器飞行员 获评「推荐使用」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色,AI 评分 7.5 分,适合有一定技术背景的用户使用。

📚 深度解析

浏览器飞行员 是一款基于 Python 的开源工具,在 GitHub 上收获 0k+ Star,是浏览器自动化、AI代理、工作流、Docker领域中的优质开源项目。开源工具的最大优势在于代码完全透明,你可以审计每一行代码的安全性,也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS?**
对于个人开发者和有隐私需求的用户,本地部署的开源工具意味着数据不离本机,不受第三方服务商的数据政策约束。同时,开源工具通常没有使用次数限制和月度费用,一次安装即可长期使用,对于高频使用场景的总拥有成本(TCO)远低于订阅制商业工具。

**安装与环境准备**
浏览器飞行员 依赖 Python 运行环境。建议通过 pyenv(Python)或 nvm(Node.js)管理 Python 版本,避免全局环境污染。对于新手用户,推荐先创建虚拟环境(python -m venv venv && source venv/bin/activate),再安装依赖,这样即使出现问题也可以随时删除虚拟环境重新开始,不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues(已关闭的问题),大多数常见问题都已有解答。遇到 Bug 时,提供 pip list 的输出、完整错误堆栈和最小可复现示例,能显著提高开发者响应速度。AI Skill Hub 将持续追踪 浏览器飞行员 的版本更新,及时通知重要功能变化。

📋 工具概览

浏览器飞行员 是一款基于 Python 开发的开源工具,专注于 浏览器自动化、AI代理、工作流 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 30
开发语言
Python
支持平台
Windows / macOS / Linux
维护状态
轻量级项目,按需更新
开源协议
Apache-2.0
AI 综合评分
7.5 分
工具类型
AI工具
Forks
2

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理,如需查看完整原始文档请访问底部「原始来源」。

浏览器飞行员 是一款基于 Python 开发的开源工具,专注于 浏览器自动化、AI代理、工作流 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费,支持本地部署,数据完全自主可控
  • 活跃的 GitHub 开源社区,持续迭代更新
  • 提供详细文档和使用示例,新手友好
  • 支持自定义配置,灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行,保护数据隐私,满足合规要求
  • 自定义集成到现有系统,扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成,实际以官方 README 为准。
安装命令
# 方式一:pip 安装(推荐)
pip install browser-pilot

# 方式二:虚拟环境安装(推荐生产环境)
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install browser-pilot

# 方式三:从源码安装(获取最新功能)
git clone https://github.com/NoDeskAI/browser-pilot
cd browser-pilot
pip install -e .

# 验证安装
python -c "import browser_pilot; print('安装成功')"
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理,涵盖最常见的使用场景。
常用命令 / 代码示例
# 命令行使用
browser-pilot --help

# 基本用法
browser-pilot input_file -o output_file

# Python 代码中调用
import browser_pilot

# 示例
result = browser_pilot.process("input")
print(result)
以下配置示例基于典型使用场景生成,具体参数请参照官方文档调整。
配置示例
# browser-pilot 配置文件示例(config.yml)
app:
  name: "browser-pilot"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
browser-pilot --config config.yml

# 或通过环境变量配置
export BROWSER_PILOT_API_KEY="your-key"
export BROWSER_PILOT_OUTPUT_DIR="./output"
📑 README 深度解析 真实文档 完整度 44/100 含工作流图 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理,保留代码块、表格与列表结构。

简介

中文

Edit passwords before production/public deployment.

Build all images and start services

docker compose build && docker compose up -d ```

Open http://localhost:8000 — you'll see the web UI with session management and a live browser viewer (noVNC).

Dashboard

Edit database credentials before production/public deployment.

Quick Start

Requires Docker (with Compose v2).

```bash git clone https://github.com/NoDeskAI/browser-pilot.git cd browser-pilot

cp .env.example .env

Configuration

VariableDefaultDescription
DATABASE_URLRequired in .env; see .env.examplePostgreSQL connection string for local backend development. Keep it aligned with POSTGRES_*.
EDITIONce in Docker Compose; auto-detected by start.sh when no edition argument is providedProduct edition. Use ce for Community Edition or ee for Enterprise Edition. EE requires the ee/ sources to be present.
POSTGRES_USERRequired in .env; see .env.examplePostgreSQL user used by Docker Compose and local development.
POSTGRES_PASSWORDRequired in .env; see .env.examplePostgreSQL password. Change it before production/public deployment.
POSTGRES_DBRequired in .env; see .env.examplePostgreSQL database name.
MINIO_ROOT_USERRequired in .env; see .env.exampleRoot user for the bundled S3-compatible storage service.
MINIO_ROOT_PASSWORDRequired in .env; see .env.exampleRoot password for the bundled S3-compatible storage service. Change it before production/public deployment.
MINIO_BUCKETRequired in .env; see .env.exampleBucket created automatically by Docker Compose and preconfigured as the default S3 storage bucket.
MINIO_ENDPOINThttp://localhost:9000 for start.sh; container-internal endpoint in Docker ComposeEndpoint used by the backend to reach the bundled S3-compatible storage service.
MINIO_PUBLIC_ENDPOINThttp://localhost:9000 in Docker ComposePublic endpoint embedded in S3 signed download URLs. It must be reachable by browsers and CLI clients.
SELENIUM_BASE_IMAGEselenium/standalone-chrome:latestBase image for browser containers. ARM users: seleniarm/standalone-chromium:latest
BROWSER_GL_MODEautoBrowser WebGL runtime mode: auto, swiftshader, angle-swiftshader, angle, egl, or native. auto resolves to angle-swiftshader for ARM Chromium and swiftshader elsewhere.
DOCKER_HOST_ADDRlocalhostHow the backend reaches browser containers. Set to host.docker.internal in Docker deployment (auto-configured by docker-compose)
BROWSER_RUNTIME_BACKEND_URLhttp://host.docker.internal:8000Backend URL injected into browser runtime agents for internal file ingest callbacks.
BROWSER_RUNTIME_CONTROL_URLOptional internal runtime-worker URL. Docker Compose sets this to http://runtime-worker:8001 so the public backend does not mount Docker socket directly.
BROWSER_RUNTIME_CONTROL_TOKENShared bearer token used between backend and runtime-worker. Set a long random value before production/public deployment.
BROWSER_RUNTIME_COMMAND_MAX_TIMEOUT3600Maximum timeout, in seconds, accepted for runtime-worker Docker commands. Large first-time runtime image builds can need a longer timeout.
CLOAK_BROWSER_IMAGE_NAMEbrowser-pilot-cloak:latestOptional Cloak Chromium runtime image used by sessions created with browserRuntime=cloak_chromium.
BROWSER_HOME_URLhttps://www.google.com/Home page opened automatically when a newly started browser is still on a blank/new-tab page. Set empty to disable.
BP_LEGACY_DOCKER_DOWNLOAD_WATCHERfalseTemporary fallback for old Selenium images without file-capture-agent. When enabled, backend uses Docker copy commands and reports a degraded warning.
OPENAI_API_KEYOptional. When set, uses LLM to auto-name sessions on first navigation. Without it, sessions are named by page title.
LOG_LEVELINFOBackend log verbosity. Set to DEBUG for troubleshooting.
JWT_EXPIRE_MINUTES30Short-lived access JWT lifetime in minutes.
REMEMBER_ME_DAYS7Duration for the revocable remember-me cookie used to restore short-lived access tokens.
NETWORK_EGRESS_DOCKER_NETWORKbrowser-pilot-netDocker bridge network used by browser containers and managed egress containers.
NETWORK_EGRESS_CONFIG_DIRdata/network-egressPrivate config storage for managed Clash/OpenVPN egress profiles.
NETWORK_EGRESS_CLASH_IMAGEghcr.io/metacubex/mihomo:latestContainer image used for managed Clash egress profiles.
NETWORK_EGRESS_CLASH_PROXY_PORT7890Proxy port exposed by managed Clash containers on the internal Docker network.
NETWORK_EGRESS_OPENVPN_IMAGEbrowser-pilot-openvpn-egress:latestContainer image used for managed OpenVPN egress profiles. The default image is built from services/network-egress-openvpn on first use.
NETWORK_EGRESS_OPENVPN_PROXY_PORT8888HTTP proxy port exposed by managed OpenVPN containers on the internal Docker network.

Option A: connect to a separate OmniParser server

export BP_OMNIPARSER_URL=http://127.0.0.1:8001

Option B: load a local OmniParser clone and weights

export BP_OMNIPARSER_REPO=/path/to/OmniParser


Example OmniParser server launch from an upstream clone:
bash cd /path/to/OmniParser/omnitool/omniparserserver python omniparserserver.py \ --host 127.0.0.1 \ --port 8001 \ --device cpu \ --som_model_path ../../weights/icon_detect/model.pt \ --caption_model_name florence2 \ --caption_model_path ../../weights/icon_caption_florence \ --BOX_TRESHOLD 0.05 ```

OmniParser code and weights are not vendored in this repository. Check the OmniParser model licenses before redistribution; its icon detection weights inherit the YOLO license noted by the upstream project.

🎯 aiskill88 AI 点评 B 级 2026-05-29

创新的浏览器即基础设施设计,为AI代理提供可靠的Web交互能力。隔离会话和指纹识别特性突出,但项目成熟度需观察,文档完整度有待提升。

📚 实用指南(长尾问题)
适合谁
  • 需要 browser-pilot 解决具体问题的开发者与运营人员
最佳实践
  • 生产部署优先使用 Docker Compose 隔离依赖,并挂载 volume 持久化数据
常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
  • Python 依赖冲突:建议用 venv / uv 隔离环境
部署方案
  • Docker:browser-pilot 提供官方镜像,docker compose up 一键启动
  • 云端托管:可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
browser-pilot 中文教程browser-pilot 安装报错怎么办browser-pilot Docker 部署browser-pilot 与同类工具对比browser-pilot 最佳实践browser-pilot 适合谁用

⚡ 核心功能

👥 适合谁
  • 需要 browser-pilot 解决具体问题的开发者与运营人员
⭐ 最佳实践
  • 生产部署优先使用 Docker Compose 隔离依赖,并挂载 volume 持久化数据
⚠️ 常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
  • Python 依赖冲突:建议用 venv / uv 隔离环境

👥 适合人群

AI 技术爱好者研究人员和学生开发者和工程师技术创业者

🎯 使用场景

  • 本地部署运行,保护数据隐私,满足合规要求
  • 自定义集成到现有系统,扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发

⚖️ 优点与不足

✅ 优点
  • +Apache-2.0 协议,可免费商用
  • +完全开源免费,无授权费用
  • +本地部署,数据完全自主可控
  • +开发者社区支持,遇问题可查可问
⚠️ 不足
  • 安装和初始配置可能需要一定技术基础
  • 功能完整性通常不如成熟商业产品
  • 技术支持主要依赖开源社区,响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。

📄 License 说明

✅ Apache 2.0 — 宽松开源协议,可商用,需保留版权声明和 NOTICE 文件,含专利授权条款。

🔗 相关工具推荐

📚 相关教程推荐
📰 相关 AI 新闻
🍿 AI 圈相关吃瓜
🗺️ 相关解决方案
🧩 你可能还需要
基于当前 Skill 的能力图谱,自动补全的工具组合

❓ 常见问题 FAQ

browser-pilot 是一款Python开发的AI辅助工具。开源AI工作流:Browser-as-infrastructure for AI agents. Isolated Chrome sessions with fingerpri。⭐30 · Python 主要应用场景包括:AI代理浏览网页自动化、智能爬虫与数据采集、Web应用自动化测试。
💡 AI Skill Hub 点评

AI Skill Hub 点评:浏览器飞行员 的核心功能完整,质量良好。对于AI爱好者来说,这是一个值得纳入个人工具库的选择。建议先在非生产环境试用,再逐步推广。

📚 深入学习 浏览器飞行员
查看分步骤安装教程和完整使用指南,快速上手这款工具
🌐 原始信息
原始名称 browser-pilot
原始描述 开源AI工作流:Browser-as-infrastructure for AI agents. Isolated Chrome sessions with fingerpri。⭐30 · Python
Topics 浏览器自动化AI代理工作流DockerSelenium
GitHub https://github.com/NoDeskAI/browser-pilot
License Apache-2.0
语言 Python
🔗 原始来源
🐙 GitHub 仓库  https://github.com/NoDeskAI/browser-pilot

收录时间:2026-05-29 · 更新时间:2026-05-30 · License:Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。