browsergym

library0.14.3pypypiunverified

BrowserGym is a Gymnasium-compatible environment for web task automation in Chromium. It provides a standardized interface for training and evaluating AI agents on web tasks, supporting both human demonstrations and automated interactions. Version 0.14.3 requires Python >3.10, with frequent releases.

ai-ml testing web-framework

pip install browsergym

package ↗homepage ↗

INSTALL

IMPORT

SIG · BROWSERGYM

browsergym

ai-mlpythonv0.14.3

Install

114.3s avg

Import

—

Disk

5939MB

Pass rate

2/ 10

Env Coverage2 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.14.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✕ timeout

py 3.11

✕ build_error

✓ 116.1s

py 3.12

✕ build_error

✓ 112.6s

py 3.13

✕ build_error

py 3.9

✕ build_error

✕ timeout

5939MB installed

● package 5939MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

make

✓ from browsergym import make

✗ import browsergym

make is the main entry point; importing the module directly is not sufficient to create environments.

Creates a MiniWoB 'click-test' environment, resets it, performs a click action, and prints the reward.

from browsergym import make import gymnasium as gym task = 'browsergym/miniwob.click-test' env = make(task, headless=True) obs, info = env.reset() # Execute a simple action (e.g., click at coordinates) action = { "action": "click", "x": 100, "y": 100 } obs, reward, terminated, truncated, info = env.step(action) print(f"Reward: {reward}") env.close()

Debug

Known issues

breakingIn version 0.14.0, the observation space changed from a dict with 'text' and 'image' keys to a Gymnaxium Dict with additional fields. Old code that directly accesses obs['text'] or obs['image'] may break.

fix

Use obs['observation']['text'] and obs['observation']['image'] or check the updated observation space structure.

affects: >=0.14.0

deprecatedThe 'browsergym/miniwob' task prefix was renamed to 'browsergym/miniwob.' (with a trailing dot) in version 0.13.0. The old prefix is deprecated and will be removed.

fix

Use 'browsergym/miniwob.' prefix (e.g., 'browsergym/miniwob.click-test').

affects: >=0.13.0

gotchaThe 'headless' argument in make() defaults to False. When running in CI or non-interactive environments, the browser may hang. Always set headless=True for automated testing.

fix

Call make(task, headless=True).

affects: all

Upgrade

Version history

0.14.3latest on PyPI · released Jan 20, 2026

Audit

Dependencies

gymnasiumrequiredCore dependency for the Gym environment API

playwrightrequiredUnderlying browser automation (Chromium)

miniwoboptionalOptional: MiniWoB++ benchmark tasks

Agent activity

21 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

packagehttps://pypi.org/project/browsergym/ ↗

homepagehttps://www.browsergym.io ↗