Skip to content
Switch branches/tags
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

The Reinforcement Learning Toybox CI

A set of games designed for testing deep RL agents.

If you use this code, or otherwise are inspired by our white-box testing approach, please cite our NeurIPS workshop paper:

  title={{Toybox: Better Atari Environments for Testing Reinforcement Learning Agents}},
  author={Foley, John and Tosch, Emma and Clary, Kaleigh and Jensen, David},
  booktitle={{NeurIPS 2018 Workshop on Systems for ML}},

We have a lenghtier paper on ArXiV and can provide a draft of a non-public paper on our acceptance testing framework by request (email at etosch at cs dot umass dot edu).

How accurate are your games?

Watch four minutes of agents playing each game. Both ALE implementations and Toybox implementations have their idiosyncracies, but the core gameplay and concepts have been captured. Pull requests always welcome to improve fidelity.

Where is the actual Rust code?

The rust implementations of the games have moved to a different repository: toybox-rs/toybox-rs


pip install ctoybox
pip install git+

Play the games (using pygame)

pip install ctoybox pygame
python -m ctoybox.human_play breakout
python -m ctoybox.human_play amidar
python -m ctoybox.human_play space_invaders

Run the tests

  1. Create a virtual environment using your python3 installation: ${python} -m venv .env
    • If you are on OSX, this is likely python3: thus, your command will be python3 -m venv .env
    • If you are not sure of your version, run python --version
  2. Activate your virtual environment: source .env/bin/activate
  3. Run pip install -r REQUIREMENTS.txt
  4. Install baselines: cd baselines && python isntall && cd ..
  5. Run python install
  6. Run python -m unittest toybox.sample_tests.test_${GAME}.${TEST_NAME}

We have observed installation issues on OSX Catalina; if you get a linker error for ujson library, you can try running with the CFLAGS argument:

CFLAGS=-stdlib=libc++ pip install ujson

If this does not work, the code will simply default back to the existing json library.


Tensorflow, OpenAI Gym, OpenCV, and other libraries may or may not break with various Python versions. We have confirmed that the code in this repository will work with the following Python versions:

  • 3.5

Get starting images for reference from ALE / atari_py

./scripts/utils/start_images --help