Introduction
Gym Anything is a framework for building and running computer-use environments.
We organize it around four parts:
src/gym_anything/: the core responsible for creating, managing and running environments.benchmarks/cua_world/: benchmark environments, tasks, and support filesagents/: reference agent implementations and evaluation loopsextras/research/: research methods built on top of the library (env creation, task generation)
The core idea is simple:
- Define an environment with a config file.
- Start it.
- Interact with it through a simple environment API.
- Optionally attach a task and an automatic checker.
- Use agents or your own control loop on top.
Who This Is For
We wrote these docs for three kinds of usage:
- people who want to install the framework and try a few environments
- people who want to modify environments, tasks, or agent loops
- people who want to contribute to the repository itself
The structure reflects that progression. The Start section gets you running, the Core / Benchmarks / Agents sections explain the main parts of the system, and Contributing plus Reference go deeper.
Mental Model
The framework should be understood in this order:
Core
Provides the basic environment API
Benchmarks
Built on top of that API
Agents
Use that API to interact with environments
Extras
Research methods that use the library (env creation, task generation)