Arcade-Learning-Environment  by Farama-Foundation

AI research platform for Atari 2600 game environments

Created 13 years ago
2,335 stars

Top 19.6% on SourcePulse

GitHubView on GitHub
Project Summary

The Arcade Learning Environment (ALE) provides a standardized platform for developing AI agents for Atari 2600 games, abstracting emulation details for researchers and hobbyists. It offers Python and C++ interfaces, with native Gymnasium integration, enabling rapid prototyping and evaluation of general AI agents.

How It Works

ALE is built upon the Stella Atari 2600 emulator, decoupling emulation logic from rendering and sound. This design choice facilitates faster execution and minimizes dependencies. It automatically extracts game scores and end-of-game signals for over 100 Atari 2600 titles, simplifying agent reward calculation and evaluation.

Quick Start & Requirements

  • Python: pip install ale-py
  • Gymnasium: pip install "gymnasium[atari]"
  • C++: Requires a C++17 compiler and vcpkg. CMake build system is used.
  • Dependencies: Atari ROMs are included with ale-py. SDL support is optional.
  • Documentation: Gymnasium Atari Page

Highlighted Details

  • Object-oriented framework supporting agent and game extensibility.
  • Multi-platform compatibility (macOS, Windows, Linux).
  • Native Gymnasium integration for seamless use with modern RL libraries.
  • Support for continuous actions via gym.make('ALE/Breakout-v5', continuous=True).

Maintenance & Community

The project is part of the Farama Foundation, a non-profit organization dedicated to supporting open-source software in machine learning.

Licensing & Compatibility

ALE is released under the BSD 3-Clause license, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

The README does not specify any known limitations or ongoing development issues.

Health Check
Last Commit

1 week ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
1
Star History
10 stars in the last 30 days

Explore Similar Projects

Starred by Aravind Srinivas Aravind Srinivas(Cofounder of Perplexity), Evan Hubinger Evan Hubinger(Head of Alignment Stress-Testing at Anthropic), and
3 more.

retro by openai

0.1%
4k
RL environment for classic video games
Created 7 years ago
Updated 1 year ago
Feedback? Help us improve.