Metadata-Version: 2.1
Name: gym_super_mario_bros
Version: 0.7.0
Summary: Super Mario Bros. for OpenAI Gym
Home-page: https://github.com/Kautenja/gym-super-mario-bros
Author: Christian Kauten
Author-email: kautencreations@gmail.com
License: MIT
Description: # OpenAI Gym - Super Mario Bros
        
        [![PackageVersion][pypi-version]][pypi-home]
        [![PythonVersion][python-version]][python-home]
        [![Stable][pypi-status]][pypi-home]
        [![Format][pypi-format]][pypi-home]
        [![License][pypi-license]](LICENSE)
        
        [pypi-version]: https://badge.fury.io/py/gym-super-mario-bros.svg
        [pypi-license]: https://img.shields.io/pypi/l/gym-super-mario-bros.svg
        [pypi-status]: https://img.shields.io/pypi/status/gym-super-mario-bros.svg
        [pypi-format]: https://img.shields.io/pypi/format/gym-super-mario-bros.svg
        [pypi-home]: https://badge.fury.io/py/gym-super-mario-bros
        [python-version]: https://img.shields.io/pypi/pyversions/gym-super-mario-bros.svg
        [python-home]: https://python.org
        
        ![smb](https://user-images.githubusercontent.com/2184469/39209488-854e960c-47cb-11e8-9e66-ddadcb0d7874.png)
        
        An [OpenAI Gym](https://github.com/openai/gym) environment for the original
        Super Mario Bros. game on the Nintendo Entertainment System (NES).
        
        # Installation
        
        The preferred installation of `gym-super-mario-bros` is from `pip`:
        
        ```shell
        pip install gym-super-mario-bros
        ```
        
        ## NES Emulator
        
        NESGym uses [FCEUX](http://www.fceux.com/web/home.html) to emulate NES games.
        Make sure it's installed and in your `$PATH`.
        
        ### Unix
        
        ```shell
        sudo apt-get install fceux
        ```
        
        ### Mac
        
        ```shell
        brew install fceux
        ```
        
        # Usage
        
        ```python
        import gym_super_mario_bros
        env = gym_super_mario_bros.make('SuperMarioBros-v0')
        
        done = True
        for step in range(5000):
            if done:
                state = env.reset()
            state, reward, done, info = env.step(env.action_space.sample())
        
        env.close()
        ```
        
        **NOTE:** `gym_super_mario_bros.make` is just an alias to `gym.make` for
        convenience.
        
        # Environments
        
        The following environments play the game as a human would. The agent has
        three lives to make it through the 32 levels of the game. The agent is
        configured to _only_ see reward-able game-play frames. No cut-scenes, loading
        screens, etc. are shown to the agent.
        
        | Environment                    | Description                                      |
        |:-------------------------------|:-------------------------------------------------|
        | `SuperMarioBros-v0`            | 4 frames per action, standard ROM                |
        | `SuperMarioBros-v1`            | 4 frames per action, custom down-sampled ROM     |
        | `SuperMarioBrosNoFrameskip-v0` | 1 frame per action, standard ROM                 |
        | `SuperMarioBrosNoFrameskip-v1` | 1 frame per action, custom down-sampled ROM      |
        
        # Citation
        
        Please cite `gym-super-mario-bros` if you use it in your research.
        
        ```tex
        @misc{gym-super-mario-bros,
          author = {Christian Kauten},
          title = {{S}uper {M}ario {B}ros for {O}pen{AI} {G}ym},
          year = {2018},
          publisher = {GitHub},
          howpublished = {\url{https://github.com/Kautenja/gym-super-mario-bros}},
        }
        ```
        
Keywords: OpenAI-Gym NES Super-Mario-Bros Reinforcement-Learning-Environment
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Games/Entertainment :: Side-Scrolling/Arcade Games
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Description-Content-Type: text/markdown
