BrowserGym

环境要求

• 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 成功下载浏览器，即表示核心依赖就绪。

常见问题

注意事项

• BrowserGym 定位为研究框架，非消费级产品，README 提示谨慎使用。
• 安装前先确定需要的基准，只装对应子包可显著减少依赖体积。
• 各基准的额外配置不在本仓库主 README 中，务必阅读对应 README 或外部项目文档。
• 开发模式克隆使用的是 SSH 地址，未配置 SSH 密钥时可改用 HTTPS 地址。