
BrowserGym
把浏览器变成 Gym 环境,让 LLM 智能体边玩边学会操作网页
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1445
使用教程
环境要求
- Python 环境(可运行 pip)
- pip 包管理器
- Playwright 支持的浏览器(需安装 chromium,约数百 MB 磁盘空间)
- 部分基准(如 WebArena、WorkArena、KNOWS)需按其各自文档完成额外配置
安装与启动步骤
-
1安装 BrowserGym
按需选择包:browsergym 含全部组件,browsergym-core 只有核心功能(无基准,仅 openended 任务),也可只装单个基准包。
pip install browsergym -
2安装 Chromium
BrowserGym 通过 Playwright 驱动浏览器,必须执行此命令下载 chromium,否则环境无法启动。
playwright install chromium -
3按需安装基准包
若只需某一基准,可改用对应子包(如 browsergym-miniwob、browsergym-webarena、browsergym-workarena)以减少依赖。
pip install browsergym-webarena -
4完成基准专属配置
每个基准有各自额外步骤:MiniWoB、WebArena、VisualWebArena、AssistantBench 看仓库内对应 README;WorkArena、KNOWS、TimeWarp、OpenApps 看外部文档。
-
5开发模式安装(可选)
需要改源码时使用:克隆仓库后进入目录执行 make install。注意 README 给出的是 SSH 地址,需已配置 GitHub SSH 密钥。
git clone git@github.com:ServiceNow/BrowserGym.git cd BrowserGym make install -
6跑通环境循环
用 Gymnasium 接口与智能体循环交互:reset 得到观测,循环内实现你的 agent 产生 action,直到 terminated 或 truncated 结束。
import gymnasium as gym import browsergym.core # register the openended task as a gym environment obs, info = env.reset() while True: action = ... # implement your agent here obs, reward, terminated, truncated, info = env.step(action) if terminated or truncated: break
如何确认成功
执行 python -c "import browsergym.core" 无报错,且 playwright install chromium 成功下载浏览器,即表示核心依赖就绪。
常见问题
Q:browsergym 和各子包该装哪个?
A:pip install browsergym 是推荐做法,包含下面所有内容;browsergym-core 仅核心功能不含基准,只提供 openended 任务;也可按需只装 browsergym-miniwob、browsergym-webarena 等单一基准包。
Q:装完包就能跑所有基准吗?
A:不能。各基准都有专属 setup,需按对应 README 或外部文档完成配置,例如 WorkArena、KNOWS、TimeWarp、OpenApps 均需查阅其各自项目文档。
Q:只执行 pip install 报浏览器相关错误怎么办?
A:README 要求额外运行 playwright install chromium 完成 Playwright 浏览器安装,缺少这一步环境无法启动。
Q:这个项目能直接用于生产吗?
A:README 明确警告:BrowserGym 是面向 Web Agent 研究的开放可扩展框架,不是消费级产品,使用时需谨慎。
Q:想实现和评测自己的 agent 有更省事的方式吗?
A:README 推荐配合 AgentLab 使用,它是一个可在全部 BrowserGym 基准上实现、测试和评测 Web Agent 的框架。
注意事项
- BrowserGym 定位为研究框架,非消费级产品,README 提示谨慎使用。
- 安装前先确定需要的基准,只装对应子包可显著减少依赖体积。
- 各基准的额外配置不在本仓库主 README 中,务必阅读对应 README 或外部项目文档。
- 开发模式克隆使用的是 SSH 地址,未配置 SSH 密钥时可改用 HTTPS 地址。
核心亮点
- 提供标准化 Gym 接口,动作与观察空间统一,便于复现和对比不同 Web Agent
- 内置多个网页任务基准,可直接用于评测 LLM 的网页操作能力
- 支持接入多种浏览器后端和主流 LLM,扩展性强,适合研究迭代
不足之处
- 真实浏览器环境依赖较重,运行和调试成本高于纯文本环境
- 任务和基准仍在演进,文档与社区生态相对早期
适用场景
- 研究团队评测不同 LLM 在网页任务上的操作能力
- 训练 Web Agent 完成表单填写、信息检索等自动化流程
- 构建可复现的网页自动化基准,用于论文实验对比
替代项目
WebArena、MiniWoB++
上一篇:webdriverio
下一篇:groovy-geb
同类项目推荐
manim-skill
开源
让 AI 代理自动生成数学动画视频,省去手动编码。
SKILL.md for creating animations with Manim.
kestra
开源
用 YAML 编排一切任务,自动调度、监控、重试,省心省力
Orchestrate everything, everywhere. The open-source control plane for workflows acro···
mixamo-llm-mocap
开源
一段视频,自动变成 Mixamo 角色动画
Turn any video into a Mixamo-rig animation - GVHMR estimator, spec-driven retarget, ···
BrowserSkill
开源
让 AI 直接操作你已登录的真实浏览器,不打断当前工作
Let AI agents use your real, logged-in browser without interrupting your work. CLI +···
surf-cli
开源
零配置让 AI 直接操控 Chrome,省去繁琐调试
The CLI for AI agents to control Chrome. Zero config, agent-agnostic, battle-tested.
Data-Copilot
开源
说一句话,让智能体自动跑完海量数据处理流程
Data-Copilot: Bridging Billions of Data and Humans with Autonomous Workflow
todo-for-ai
开源
让 AI 助手自己管任务,项目进度不再丢在对话里
A comprehensive task management system specifically designed for AI assistants. Supp···
altimate-code
开源
AI 代理帮你写 SQL 调 dbt 查仓库,数据工程少加班
Open-source agentic data engineering harness for dbt, SQL, and cloud warehouses. 100···
webmcp-sdk
开源
让大模型无需改码,远程操控任意网页,快速构建 AI 应用。
OpenTiny NEXT-SDKs is a front-end AI and browser automation toolkit. It implements W···