Awesome Open Source
Awesome Open Source

DEPRECATED

RLE has been succeeded by the wonderful work of the folks at OpenAI under their repository Gym-retro. Since they now support all the consoles and games that we supported and most of our features, there's no reason to maintain this one.

Retro-Learning-Environment

A learning framework based on the Arcade Learning Environment (ALE) and Libretro (Stella for Atari and SNES9X for the Super Nintendo Entertainment System).

The environment provides an interface to training and evaluating AI algorithms against different console games using its screen as input.

The currently supported games can be found in the src/games/supported directory . Some popular games include: Mortal Kombat, Super Mario All Stars, F-Zero, Castle Wolfenstein and Gradius III.

A paper is available for RLE at http://arxiv.org/abs/1611.02205. If you use RLE in your publication, please use the following BibTex entry:

@article{bhonker2016playing,
  title = {Playing SNES in the Retro Learning Environment},
  author = {Bhonker, Nadav and Rozenberg, Shai and Hubara, Itay},
  journal = {arXiv preprint arXiv:1611.02205},
  year = {2016}
}

Quick Start

Install main dependencies:

sudo apt-get install libsdl1.2-dev libsdl-gfx1.2-dev libsdl-image1.2-dev cmake

To install as a Gym environment:
Go to the gym-rle repository and follow the instructions there.

To install the python interface:
Either install via PyPi:

$ pip install rle-python-interface

or by cloning the repository and running the following:

$ pip install .
or
$ pip install --user .

To use the shared_library interface:

$ mkdir build && cd build
$ cmake -DUSE_SDL=ON -DBUILD_EXAMPLES=ON ..
$ make -j4

To install the lua (Torch) interface, the additional alewrap module is required:

luarocks install https://raw.githubusercontent.com/nadavbh12/Retro-Learning-Environment/master/ale-2-0.rockspec
luarocks install https://raw.githubusercontent.com/nadavbh12/alewrap/master/alewrap-0-0.rockspec

DQN Implementations Using RLE

Acknowledgements

  • @mgbellemare for his work on ALE and his useful advice.
  • @Alcaro and the @libretro community for their assistance in incorporating their work into our framework.


Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Plus Plus (235,680
Video Game (82,446
Learning (76,514
Machine Learning (36,405
Artificial Intelligence (18,737
Game Engine (4,565
Reinforcement Learning (4,342
Gym (2,501
Retro (1,586
Dqn (1,409