Skip to content

🐍 πŸ‹ OpenAI GYM for Nintendo NES emulator FCEUX and 1983 game Mario Bros. + Double Q Learning for mastering the game

License

Notifications You must be signed in to change notification settings

Naereen/gym-nes-mario-bros

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

69 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OpenAI Gym for NES games + DQN with Keras to learn Mario Bros. from raw pixels

  • An EXPERIMENTAL openai-gym wrapper for NES games.
  • With a Double Deep Q Network to learn how to play Mario Bros. game from 1983.

Installation

You can use a virtualenv or a pipenv if you want to install the dependencies in an isolated environment.

  1. Use Python 3 only.
  2. Install openai-gym and keras with tensorflow backend (with pip), and cv2 (OpenCV module, on Debian/Ubuntu, sudo pip install opencv-python, see this SO question).
  3. Install the fceux NES emulator and make sure fceux is in your $PATH. In Debian/Ubuntu, you can simple use sudo apt install fceux. Version 2 at least is needed.
  4. Find a .nes ROM for Mario Bros. game (any dump for the Nintendo NES will do). Save it to src/roms/mario_bros.nes.
  5. Copy state files from roms/fcs/* to your ~/.fceux/fcs/ (faster loading for the beginning of the game).

Example usage

For instance to load the Mario Bros. environment:

# import nesgym to register environments to gym
import nesgym
env = gym.make('nesgym/MarioBros-v0')
obs = env.reset()

for step in range(10000):
    action = env.action_space.sample()
    obs, reward, done, info = env.step(action)
    ... # your awesome reinforcement learning algorithm is here

Examples for training dqn

An implementation of dqn is in src/dqn, using keras.

You can train dqn model for Atari with run-atari.py and for NES with run-soccer.py or run-mario.py.

Integrating new NES games?

You need to write two files:

  1. a lua interface file,
  2. and an openai gym environment class (python) file.

The lua file needs to get the reward from emulator (typically extracting from a memory location), and the python file defines the game specific environment.

For an example of lua file, see src/lua/soccer.lua; for an example of gym env file, see src/nesgym/nekketsu_soccer_env.py.

This website gives RAM mapping for the most well-known NES games, this is very useful to extract easily the score or lives directly from the NES RAM memory, to use it as a reward for the reinforcement learning loop. See for instance for Mario Bros..

Gallery

Training Atari games

images/atari.png

Training NES games

Mario Bros. game

images/mario.png

That's new!

Architecture of the DQN playning mario:

images/dqn_base.png

Overview of the experimentation with 3 emulators:

images/record_mario.gif

Soccer game

images/soccer.png


πŸ“œ License ? GitHub license

This (small) repository is published under the terms of the MIT license (file LICENSE). Β© Lilian Besson, 2018.

Maintenance Ask Me Anything ! Analytics

made-with-OpenAIGym made-with-Fceux made-with-Python made-with-Lua made-with-Keras made-with-TensorFlow made-with-OpenCV

ForTheBadge built-with-swag ForTheBadge uses-badges ForTheBadge uses-git

About

🐍 πŸ‹ OpenAI GYM for Nintendo NES emulator FCEUX and 1983 game Mario Bros. + Double Q Learning for mastering the game

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published