External Environments¶
First-Party Environments¶
The Farama Foundation maintains a number of other projects, which use the Gymnasium API, environments include: gridworlds (Minigrid), robotics (Gymnasium-Robotics), 3D navigation (Miniworld), web interaction (MiniWoB++), arcade games (Arcade Learning Environment), Doom (ViZDoom), Meta-objective robotics (Metaworld), autonomous driving (HighwayEnv), Retro Games (stable-retro), and many more.
The Farama Foundation also maintains alternate APIs for RL, including: multi-agent RL (PettingZoo), offline-RL (Minari), multi-objective RL (MO-Gymnasium), goal-RL (Gymnasium-Robotics).
Third-party environments with Gymnasium¶
This page contains environments which are not maintained by Farama Foundation and, as such, cannot be guaranteed to function as intended.
If you’d like to contribute an environment, please reach out on Discord, then submit a PR by editing this file.
Autonomous Driving environments¶
Autonomous Vehicle and traffic management.
gym-electric-motor: Gym environments for electric motor simulations
An environment for simulating a wide variety of electric drives taking into account different types of electric motors and converters.
racecar_gym: Miniature racecar env using PyBullet
A gym environment for a miniature racecar using the PyBullet physics engine.
sumo-rl: Reinforcement Learning using SUMO traffic simulator
Gymnasium wrapper for various environments in the SUMO traffic simulator. Supports both single and multiagent settings (using pettingzoo).
Biological / Medical environments¶
Interacting with Biological Systems.
ICU-Sepsis: A Benchmark MDP Built from Real Medical Data
ICU-Sepsis is a tabular reinforcement learning environment that simulates the treatment of sepsis in an intensive care unit (ICU). Introduced in the paper ICU-Sepsis: A Benchmark MDP Built from Real Medical Data, the environment is lightweight and easy to use, yet challenging for most reinforcement learning algorithms.
Economic / Financial environments¶
Everything Economics related.
gym-anytrading: Financial trading environments for FOREX and STOCKS
AnyTrading is a collection of Gym environments for reinforcement learning-based trading algorithms with a great focus on simplicity, flexibility, and comprehensiveness.
gym-mtsim: Financial trading for MetaTrader 5 platform
MtSim is a simulator for the MetaTrader 5 trading platform for reinforcement learning-based trading algorithms.
gym-trading-env: Trading Environment
Gym Trading Env simulates stock (or crypto) market from historical data. It was designed to be fast and easily customizable.
Electrical / Energy environments¶
Manage the flow of Electrons.
EV2Gym: A Realistic EV-V2G-Gym Simulator for EV Smart Charging
EV2Gym is a fully customizable and easily configurable environment for Electric Vehicle (EV) smart charging simulations on a small and large scale. Also, includes non-RL baseline implementations such as mathematical programming, model predictive control, and heuristics.
Game environments¶
Board Games, Video Games and all other interactive entrainment mediums.
Craftium: an extensible framework for creating RL environments
Craftium wraps the Minetest game engine into the Gymnasium API, providing a modern and easy-to-use platform for designing Minecraft-like RL environments.
-
Flappy Bird as a Farama Gymnasium environment.
flappy-bird-gymnasium: A Flappy Bird environment for Gymnasium
A simple environment for single-agent reinforcement learning algorithms on a clone of Flappy Bird, the hugely popular arcade-style mobile game. Both state and pixel observation environments are available.
pystk2-gymnasium: SuperTuxKart races gymnasium wrapper
Uses a python wrapper around SuperTuxKart that allows to access the world state and to control a race.
QWOP: An environment for Bennet Foddy’s game QWOP
QWOP is a game about running extremely fast down a 100 meter track. With this Gymnasium environment you can train your own agents and try to beat the current world record (5.0 in-game seconds for humans and 4.7 for AI).
Tetris Gymnasium: A fully configurable Gymnasium compatible Tetris environment
Tetris Gymnasium is a clean implementation of Tetris as a Gymnasium environment. It can be extensively customized (e.g. board dimensions, gravity, …), is well documented and includes many examples on how to use it e.g. by providing training scripts.
tmrl: TrackMania 2020 through RL
tmrl is a distributed framework for training Deep Reinforcement Learning AIs in real-time applications. It is demonstrated on the TrackMania 2020 video game.
Mathematics / Computational¶
Reduce computational compute, prove math theorems, and more.
spark-sched-sim: Environments for scheduling DAG jobs in Apache Spark
spark-sched-sim simulates Spark clusters for RL-based job scheduling algorithms. Spark jobs are encoded as directed acyclic graphs (DAGs), providing opportunities to experiment with graph neural networks (GNN’s) in the RL context.
gym-saturation: Environments used to prove theorems
An environment for guiding automated theorem provers based on saturation algorithms (e.g. Vampire).
Robotics environments¶
Autonomous Robots.
BSK-RL: Environments for Spacecraft Planning and Scheduling
BSK-RL is a Python package for constructing Gymnasium environments for spacecraft tasking problems. It is built on top of Basilisk, a modular and fast spacecraft simulation framework, making the simulation environments high-fidelity and computationally efficient. BSK-RL also includes a collection of utilities and examples for working with these environments
Connect-4-gym : An environment for practicing self playing
Connect-4-Gym is an environment designed for creating AIs that learn by playing against themselves and assigning them an Elo rating. This environment can be used to train and evaluate reinforcement learning agents on the classic board game Connect Four.
FlyCraft: A Fixed-wing UAV Environment
FlyCraft is a Gymnasium environment for fixed-wing UAV tasks. By default, FlyCraft provides two tasks: attitude control and velocity vector control. These tasks are characterized by their multi-goal and long-horizon nature, posing significant challenges for RL exploration. Additionally, the rewards can be configured as either Markovian or non-Markovian, making FlyCraft suitable for research on non-Markovian problems.
gymnax: Hardware Accelerated RL Environments
RL Environments in JAX which allows for highly vectorised environments with support for a number of environments, Gym, MinAtari, bsuite and more.
gym-jiminy: Training Robots in Jiminy
gym-jiminy presents an extension of the initial Gym for robotics using Jiminy, an extremely fast and light-weight simulator for poly-articulated systems using Pinocchio for physics evaluation and Meshcat for web-based 3D rendering.
gym-pybullet-drones: Environments for quadcopter control
A simple environment using PyBullet to simulate the dynamics of a Bitcraze Crazyflie 2.x nanoquadrotor.
OmniIsaacGymEnvs: Gym environments for NVIDIA Omniverse Isaac
Reinforcement Learning Environments for Omniverse Isaac simulator.
panda-gym: Robotics environments using the PyBullet physics engine
PyBullet based simulations of a robotic arm moving objects.
PyFlyt: UAV Flight Simulator Environments for Reinforcement Learning Research
A library for testing reinforcement learning algorithms on various UAVs. It is built on the Bullet physics engine, offers flexible rendering options, time-discrete steppable physics, Python bindings, and support for custom drones of any configuration, be it biplanes, quadcopters, rockets, and anything you can think of.
safe-control-gym: Evaluate safety of RL algorithms
Evaluate safety, robustness and generalization via PyBullet based CartPole and Quadrotor environments—with CasADi (symbolic) a priori dynamics and constraints.
Safety-Gymnasium: Ensuring safety in real-world RL scenarios
Highly scalable and customizable Safe Reinforcement Learning library.
Telecommunication Systems environments¶
Interact and/or manage wireless and/or wired telecommunication systems.
mobile-env: Environments for coordination of wireless mobile networks
An open, minimalist Gymnasium environment for autonomous coordination in wireless mobile networks.
Other¶
Buffalo-Gym: Multi-Armed Bandit Gymnasium
Buffalo-Gym is a Multi-Armed Bandit (MAB) gymnasium built primarily to assist in debugging RL implementations. MABs are often easy to reason about what the agent is learning and whether it is correct. Buffalo-gym encompasses Bandits, Contextual bandits, and contextual bandits with aliasing.
-
Contextual extensions of popular reinforcement learning environments that enable training and test distributions for generalization, e.g. CartPole with variable pole lengths or Brax robots with different ground frictions.
DACBench: a benchmark for Dynamic Algorithm Configuration
A benchmark library for Dynamic Algorithm Configuration. Its focus is on reproducibility and comparability of different DAC methods as well as easy analysis of the optimization process.
gym-cellular-automata: Cellular Automata environments
Environments where the agent interacts with Cellular Automata by changing its cell states.
Gym-Gridworlds: Collection of Customizable Minimalistic Gridworlds
The default class implements a “go-to goal”, but it can be easily customized for different tasks, with a variety of grids, rewards, dynamics, and tasks. It supports different observation types (discrete, coordinates, binary, pixels, partial). Useful for quickly testing and prototyping RL algorithms, both tabular and with function approximation.
matrix-mdp: Easily create discrete MDPs
An environment to easily implement discrete MDPs as gym environments. Turn a set of matrices (
P_0(s)
,P(s'| s, a)
andR(s', s, a)
) into a gym environment that represents the discrete MDP ruled by these dynamics.SimpleGrid: a simple grid environment for Gymnasium
SimpleGrid is a super simple and minimal grid environment for Gymnasium. It is easy to use and customise and it is intended to offer an environment for rapidly testing and prototyping different RL algorithms.
Third-Party Environments using Gym¶
There are a large number of third-party environments using various versions of Gym. Many of these can be adapted to work with gymnasium (see Compatibility with Gym), but are not guaranteed to be fully functional.
Video Game environments¶
gym-derk: GPU accelerated MOBA environment
A 3v3 MOBA environment where you train creatures to fight each other.
SlimeVolleyGym: A simple environment for Slime Volleyball game
A simple environment for benchmarking single and multi-agent reinforcement learning algorithms on a clone of Slime Volleyball game.
Unity ML Agents: Environments for Unity game engine
Gym (and PettingZoo) wrappers for arbitrary and premade environments with the Unity game engine.
-
Uses The Open 3D Engine for AI simulations and can interoperate with the Gym. Uses PyBullet physics.
Robotics environments¶
MarsExplorer: Environments for controlling robot on Mars
Mars Explorer is a Gym compatible environment designed and developed as an initial endeavor to bridge the gap between powerful Deep Reinforcement Learning methodologies and the problem of exploration/coverage of an unknown terrain.
robo-gym: Real-world and simulation robotics
Robo-gym provides a collection of reinforcement learning environments involving robotic tasks applicable in both simulation and real-world robotics.
Offworld-gym: Control real robots remotely for free
Gym environments that let you control real robots in a laboratory via the internet.
gym-softrobot: Soft-robotics environments
A large-scale benchmark for co-optimizing the design and control of soft robots.
iGibson: Photorealistic and interactive robotics environments
A simulation environment with high-quality realistic scenes, with interactive physics using PyBullet.
DexterousHands: Dual dexterous hand manipulation tasks
This is a library that provides dual dexterous hand manipulation tasks through Isaac Gym.
Autonomous Driving environments¶
gym-duckietown: Lane-following for self-driving cars
A lane-following simulator built for the Duckietown project (small-scale self-driving car course).
CommonRoad-RL: Motion planning for traffic scenarios
A Gym for solving motion planning problems for various traffic scenarios compatible with CommonRoad benchmarks, which provides configurable rewards, action spaces, and observation spaces.
racing_dreamer: Latent imagination in autonomous racing
Train a model-based RL agent in simulation and, without finetuning, transfer it to small-scale race cars.
l2r: Multimodal control environment where agents learn how to race
An open-source reinforcement learning environment for autonomous racing.
Other environments¶
CompilerGym: Optimise compiler tasks
Reinforcement learning environments for compiler optimization tasks, such as LLVM phase ordering, GCC flag tuning, and CUDA loop nest code generation.
gym-sokoban: 2D Transportation Puzzles
The environment consists of transportation puzzles in which the player’s goal is to push all boxes to the warehouse’s storage locations.
NLPGym: A toolkit to develop RL agents to solve NLP tasks
NLPGym provides interactive environments for standard NLP tasks such as sequence tagging, question answering, and sequence classification.
ShinRL: Environments for evaluating RL algorithms
ShinRL: A Library for Evaluating RL Algorithms from Theoretical and Practical Perspectives (Deep RL Workshop 2021)
openmodelica-microgrid-gym: Environments for controlling power electronic converters in microgrids
The OpenModelica Microgrid Gym (OMG) package is a software toolbox for the simulation and control optimization of microgrids based on energy conversion by power electronic converters.
GymFC: A flight control tuning and training framework
GymFC is a modular framework for synthesizing neuro-flight controllers. Has been used to generate policies for the world’s first open-source neural network flight control firmware Neuroflight.