Status: Deprecated (don't expect bug fixes or other updates)
atari-py is fully deprecated and no future updates, bug fixes or releases will be made.
Please use the official Arcade Learning Environment Python package (
it is fully backwards compatible with all
A packaged and slightly-modified version of https://github.com/bbitmaster/ale_python_interface.
atari-py supports Linux and Mac OS X with Python 3.5, 3.6, and 3.7. Binaries for those platforms are published to PyPI
We also have binaries for Windows, but compiling from source on Windows or using the binaries is not officially supported.
To install via pip, run:
pip install atari-py
That should install a correct binary verison for your OS. If that does not work (or if you would like get the latest-latest
version, or you just want to tinker with the code yourself) see next paragraph.
In order to import ROMS, you need to download
Roms.rar from the Atari 2600 VCS ROM Collection and extract the
.rar file. Once you've done that, run:
python -m atari_py.import_roms <path to folder>
This should print out the names of ROMs as it imports them. The ROMs will be copied to your
atari_py installation directory.
zlib1g, and, on Linux,
zlib1g-devsystem packages installed
pip install -e .
The following non-commercial ROMs are included with atari-py for testing purposes: