browsergym-visualwebarena

0.14.3 verified Fri May 01 auth: no python

VisualWebArena benchmark integration for BrowserGym. Version 0.14.3, released as part of the BrowserGym ecosystem. Provides environments for evaluating multimodal web agents on visual tasks. Release cadence follows BrowserGym releases.

pip install browsergym-visualwebarena

Common errors

error ModuleNotFoundError: No module named 'browsergym' ↓

cause browsergym not installed

fix

pip install browsergym

error gym.error.UnregisteredEnvironment: browsergym/visualwebarena.0 ↓

cause Environment not registered because visualwebarena import failed or task ID is wrong

fix

Ensure browsergym.visualwebarena is imported: import browsergym.visualwebarena

error pyglet.canvas.xlib.NoSuchDisplayException: Cannot connect to X server ↓

cause No display server running

fix

Run with virtual display: xvfb-run python script.py or set DISPLAY env variable

Warnings

breaking browsergym-visualwebarena requires a specific version of BrowserGym. Ensure browsergym is installed with version compatible with your visualwebarena version (e.g., use the same release). ↓

fix Install both from the same release: pip install browsergym==0.14.3 browsergym-visualwebarena==0.14.3

gotcha Environment IDs are case-sensitive and must be specified exactly. Use browsergym/visualwebarena.<task_id> (lowercase, no spaces). ↓

fix List available tasks with: from browsergym.visualwebarena import ALL_VISUALWEBAREA_TASKS; print(ALL_VISUALWEBAREA_TASKS)

gotcha The visualwebarena tasks require WebCanvas rendering; ensure your system has a display or use xvfb. ↓

fix Run with xvfb: xvfb-run python your_script.py

deprecated Importing from 'visualwebarena' directly (without 'browsergym.') is deprecated and will be removed in a future version. ↓

fix Use 'from browsergym.visualwebarena import ...'

Imports

VisualWebArenaEnv
wrong
```
from visualwebarena import VisualWebArenaEnv
```
correct
```
from browsergym.visualwebarena import VisualWebArenaEnv
```
VisualWebArena is a submodule of browsergym; import from browsergym namespace.

ALL_VISUALWEBARENA_TASKS

wrong

from browsergym_visualwebarena import ALL_VISUALWEBARENA_TASKS

correct

from browsergym.visualwebarena import ALL_VISUALWEBARENA_TASKS

The PyPI package name has hyphens, but the import uses underscores.

Quickstart

Create a VisualWebArena environment instance using Gymnasium's make function. The environment ID follows the pattern browsergym/visualwebarena.<task_id>.

import gymnasium as gym
import browsergym.visualwebarena

env = gym.make('browsergym/visualwebarena.0')
obs, info = env.reset()
print(obs.keys())