← all repositories
Farama-Foundation/Stable-Retro

Gym-retro's afterlife: 1,000+ games under active maintenance

Because OpenAI's gym-retro froze, this fork keeps 1,000+ classic games playable as Gymnasium RL environments.

794 stars C++ ML FrameworksDomain Apps
Stable-Retro
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does Stable-Retro wraps fourteen classic console and arcade emulators into Gymnasium environments for reinforcement learning. It bundles integrations for over 1,000 games—including memory locations, reward functions, and level savestates—so you can train agents on titles ranging from Super Mario World to Street Fighter II. ROMs are not included, but a hash-matching importer and an integration tool let you wire in your own legally obtained copies.

The interesting bit This is community life-support for OpenAI’s gym-retro, which is now in maintenance mode. The Farama Foundation took the original, expanded the emulator roster to systems like the Sega Saturn and Nintendo DS, and opened the door for new game submissions—turning a static research artifact into an actively maintained benchmark suite.

Key highlights

  • 14 emulated systems, from Atari 2600 through Sega Dreamcast and Arcade machines
  • Over 1,000 games with pre-defined reward functions and savestates
  • Cross-platform support for Linux, macOS (including Apple Silicon), and Windows via WSL2
  • Python 3.10 through 3.14 compatibility
  • Built-in tooling for integrating new ROMs and emulator cores

Caveats

  • N64 and Dreamcast cores are gated behind build flags and platform-specific rendering requirements; Dreamcast hardware rendering is currently Linux-only
  • Apple Silicon builds skip the Gameboy (Gambatte) core by default
  • You must source your own ROMs and BIOS files; nothing is bundled except a single test ROM

Verdict A solid choice for RL researchers who want a maintained, expanding library of classic game benchmarks. Less appealing if you need turnkey ROM distribution or guaranteed builds for every niche core on every platform.

Frequently asked

What is Farama-Foundation/Stable-Retro?
Because OpenAI's gym-retro froze, this fork keeps 1,000+ classic games playable as Gymnasium RL environments.
Is Stable-Retro open source?
Yes — Farama-Foundation/Stable-Retro is open source, released under the MIT license.
What language is Stable-Retro written in?
Farama-Foundation/Stable-Retro is primarily written in C++.
How popular is Stable-Retro?
Farama-Foundation/Stable-Retro has 794 stars on GitHub.
Where can I find Stable-Retro?
Farama-Foundation/Stable-Retro is on GitHub at https://github.com/Farama-Foundation/Stable-Retro.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.