Skip to content
Switch branches/tags

Latest commit

* Switch to multibuild main branch

* Add Python 3.8 and 3.9 builds to CI

* Add more build architectures

* Pass arch flag into multibuild

* Use docker-compatible arch flags

* Switch to use manylinux2014 container for builds

* Specify test image for arm64 builds

* Remove legacy python 3.5 build

* Pinned multibuild to latest version

Git stats


Failed to load latest commit information.

Status: Maintenance (expect bug fixes and minor updates)


Build Status

A packaged and slightly-modified version of

Supported Systems

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.

Installation from source

  • make sure you have git, cmake, zlib1g, and, on Linux, zlib1g-dev system packages installed
  • clone the repo
  • run pip install -e .

Included ROMs

The following non-commercial ROMs are included with atari-py for testing purposes:

  • Tetris26 by Colin Hughes