{"id":21300101,"url":"https://github.com/roclark/super-mario-bros-rllib","last_synced_at":"2025-10-10T08:35:48.189Z","repository":{"id":96260598,"uuid":"322113902","full_name":"roclark/super-mario-bros-rllib","owner":"roclark","description":"A collection of models from the Ray Project's RLLib used to train and beat Super Mario Bros. for the NES.","archived":false,"fork":false,"pushed_at":"2020-12-21T01:40:20.000Z","size":5,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-10T08:35:23.374Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roclark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-12-16T22:09:16.000Z","updated_at":"2023-11-26T13:54:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"e02af84b-7657-4302-a632-3de82e8c0177","html_url":"https://github.com/roclark/super-mario-bros-rllib","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/roclark/super-mario-bros-rllib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roclark%2Fsuper-mario-bros-rllib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roclark%2Fsuper-mario-bros-rllib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roclark%2Fsuper-mario-bros-rllib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roclark%2Fsuper-mario-bros-rllib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roclark","download_url":"https://codeload.github.com/roclark/super-mario-bros-rllib/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roclark%2Fsuper-mario-bros-rllib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279003277,"owners_count":26083555,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T15:07:29.677Z","updated_at":"2025-10-10T08:35:48.184Z","avatar_url":"https://github.com/roclark.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Super Mario Bros. RLLib\nA reinforcement learning project designed to learn and complete the original\nSuper Mario Bros. for the Nintendo Entertainment System using various models\nfrom the RLLib library from Ray.\n\n## Setting up the repository\n\n### Creating a virtual environment\nAfter cloning the repository, it is highly recommended to install a virtual\nenvironment (such as `virtualenv`) or Anaconda to isolate the dependencies of\nthis project with other system dependencies.\n\nTo install `virtualenv`, simply run\n\n```\npip install virtualenv\n```\n\nOnce installed, a new virtual environment can be created by running\n\n```\nvirtualenv env\n```\n\nThis will create a virtual environment in the `env` directory in the current\nworking directory. To change the location and/or name of the environment\ndirectory, change `env` to the desired path in the command above.\n\nTo enter the virtual environment, run\n\n```\nsource env/bin/activate\n```\n\nYou should see `(env)` at the beginning of the terminal prompt, indicating the\nenvironment is active. Again, replace `env` with your desired directory name.\n\nTo get out of the environment, simply run\n\n```\ndeactivate\n```\n\n### Installing Dependencies\nWhile the virtual environment is active, install the required dependencies by\nrunning\n\n```\npip -r requirements.txt\n```\n\nThis will install all of the dependencies at specific versions to ensure they\nare compatible with one another.\n\n## Training a model\n\nTo train a model, use the `train.py` script and specify any parameters that need\nto be changed, such as the environment or epsilon decay factors. A list of the\ndefault values for every parameters can be found by running\n\n```\npython train.py --help\n```\n\nIf you desire to run with the default settings, execute the script directly with\n\n```\npython train.py\n```\n\nThe script will train the default environment over a set number of episodes and\ndisplay the training progress after the conclusion of every episode. The updates\nindicate the episode number, the reward for the current episode, the best reward\nthe model has achieved so far, a rolling average of the previous 100 episode\nrewards, and the current value for epsilon.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froclark%2Fsuper-mario-bros-rllib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froclark%2Fsuper-mario-bros-rllib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froclark%2Fsuper-mario-bros-rllib/lists"}