BrowserGym MiniWoB

0.14.3 verified Mon Apr 27 auth: no python

MiniWoB++ benchmark environment for BrowserGym that provides web interaction tasks for training and evaluating reinforcement learning agents. Version 0.14.3 supports Python >3.7 and integrates with gymnasium. Maintained as part of the BrowserGym ecosystem.

pip install browsergym-miniwob

Common errors

error ModuleNotFoundError: No module named 'browsergym' ↓

cause Missing browsergym-core package.

fix

Install browsergym-core: pip install browsergym-core

error gym.error.UnregisteredEnvironment: minigob.click-test-2-v1 ↓

cause Using old environment ID without 'browsergym/' prefix.

fix

Use gym.make('browsergym/miniwob.click-test-2-v1') instead.

error RuntimeError: Browser closed. Please make sure Playwright is installed. ↓

cause Playwright browser binaries not installed.

fix

Run 'playwright install' after pip install playwright.

Warnings

breaking In version 0.14.x, the environment ID format changed from 'miniwob.click-test-2-v1' to 'browsergym/miniwob.click-test-2-v1'. Old IDs will raise an error. ↓

fix Use prefix 'browsergym/miniwob.' in gym.make().

deprecated Support for Python 3.7 is deprecated in version 0.14.x and will be removed in a future release. ↓

fix Upgrade to Python 3.8 or higher.

gotcha The environment must be started with Playwright browser. If not installed, calling env.reset() raises a RuntimeError. ↓

fix Install playwright and run 'playwright install'.

Imports

MiniWoBEnv
wrong
```
from browsergym_miniwob import MiniWoBEnv
```
correct
```
from browsergym.miniwob import MiniWoBEnv
```
Package uses dot notation, not underscore. 'browsergym.miniwob' is correct.

task_list

wrong

from browsergym.miniwob.tasks import task_list

correct

from browsergym.miniwob import task_list

task_list is directly under browsergym.miniwob, not in a submodule.

Quickstart

Import the package to register MiniWoB tasks with gymnasium, then create an environment and reset it.

import gymnasium as gym
import browsergym.miniwob  # noqa F401

env = gym.make('browsergym/miniwob.click-test-2-v1')
obs, info = env.reset()
print(obs.keys())