BrowserGym

把浏览器变成 Gym 环境,让 LLM 智能体边玩边学会操作网页

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 216 🐛 待处理 52 👀 关注 10
GitHub ↗
GitHub 星标 ★ 1445
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费

项目预览

BrowserGym 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队ServiceNow
定价模式🏷️完全免费
价格说明开源免费
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型ai,llm,webagent
GitHub 星标★ 1445
上线时间2024-02-07 00:00:00
代码更新2026-11-18
仓库体积1.6 MB
本站数据更新2026-11-22
维护状态活跃
收录时间2026-10-08
浏览次数4

项目介绍

BrowserGym 是一个面向网页任务自动化的 Gym 风格环境,专为训练和评测基于大语言模型的 Web Agent 而设计。它把真实浏览器封装成标准化环境,让智能体可以像玩游戏一样观察页面、执行点击、输入、滚动等动作,并接收反馈。项目解决了 Web Agent 研究缺乏统一评测基准和可复现环境的问题,提供统一的动作空间、观察空间和任务定义,支持接入多种浏览器后端和现有 LLM。核心能力包括:标准化 Gym 接口、多任务基准(如 MiniWoB、WebArena 等)、可扩展的动作与观察抽象、与主流 LLM 和 Agent 框架的集成,方便研究者对比不同模型在真实网页操作中的表现,推动 Web 自动化从脚本化走向智能决策。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1445

技术标签

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 6 步

环境要求

  • Python 环境(可运行 pip)
  • pip 包管理器
  • Playwright 支持的浏览器(需安装 chromium,约数百 MB 磁盘空间)
  • 部分基准(如 WebArena、WorkArena、KNOWS)需按其各自文档完成额外配置

安装与启动步骤

  1. 1安装 BrowserGym

    按需选择包:browsergym 含全部组件,browsergym-core 只有核心功能(无基准,仅 openended 任务),也可只装单个基准包。

    pip install browsergym
  2. 2安装 Chromium

    BrowserGym 通过 Playwright 驱动浏览器,必须执行此命令下载 chromium,否则环境无法启动。

    playwright install chromium
  3. 3按需安装基准包

    若只需某一基准,可改用对应子包(如 browsergym-miniwob、browsergym-webarena、browsergym-workarena)以减少依赖。

    pip install browsergym-webarena
  4. 4完成基准专属配置

    每个基准有各自额外步骤:MiniWoB、WebArena、VisualWebArena、AssistantBench 看仓库内对应 README;WorkArena、KNOWS、TimeWarp、OpenApps 看外部文档。

  5. 5开发模式安装(可选)

    需要改源码时使用:克隆仓库后进入目录执行 make install。注意 README 给出的是 SSH 地址,需已配置 GitHub SSH 密钥。

    git clone git@github.com:ServiceNow/BrowserGym.git
    cd BrowserGym
    make install
  6. 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.

★ 215 2026-08-09
kestra 开源

用 YAML 编排一切任务,自动调度、监控、重试,省心省力

Orchestrate everything, everywhere. The open-source control plane for workflows acro···

★ 30302 2026-08-09
mixamo-llm-mocap 开源

一段视频,自动变成 Mixamo 角色动画

Turn any video into a Mixamo-rig animation - GVHMR estimator, spec-driven retarget, ···

★ 452 2026-09-16
BrowserSkill 开源

让 AI 直接操作你已登录的真实浏览器,不打断当前工作

Let AI agents use your real, logged-in browser without interrupting your work. CLI +···

★ 10628 2026-09-12
surf-cli 开源

零配置让 AI 直接操控 Chrome,省去繁琐调试

The CLI for AI agents to control Chrome. Zero config, agent-agnostic, battle-tested.

★ 704 2026-08-09
Data-Copilot 开源

说一句话,让智能体自动跑完海量数据处理流程

Data-Copilot: Bridging Billions of Data and Humans with Autonomous Workflow

★ 1510 2026-10-23
todo-for-ai 开源

让 AI 助手自己管任务,项目进度不再丢在对话里

A comprehensive task management system specifically designed for AI assistants. Supp···

★ 1194 2026-10-08
altimate-code 开源

AI 代理帮你写 SQL 调 dbt 查仓库,数据工程少加班

Open-source agentic data engineering harness for dbt, SQL, and cloud warehouses. 100···

★ 822 2026-09-16
webmcp-sdk 开源

让大模型无需改码,远程操控任意网页,快速构建 AI 应用。

OpenTiny NEXT-SDKs is a front-end AI and browser automation toolkit. It implements W···

★ 125 2026-08-09