Need help with atari-py?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

234 Stars 165 Forks Other 369 Commits 14 Opened issues


A packaged and slightly-modified version of

Services available


Need anything else?

Contributors list

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

from the Atari 2600 VCS ROM Collection and extract the
file. Once you've done that, run:

python -m atari_py.import_roms 

This should print out the names of ROMs as it imports them. The ROMs will be copied to your

installation directory.

Installation from source

  • make sure you have
    , and, on Linux,
    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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.