{"id":19664988,"url":"https://github.com/jonghough/proton","last_synced_at":"2026-04-09T21:52:16.349Z","repository":{"id":150486471,"uuid":"398563967","full_name":"jonghough/proton","owner":"jonghough","description":null,"archived":false,"fork":false,"pushed_at":"2021-08-21T13:34:29.000Z","size":364,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-10T02:25:42.861Z","etag":null,"topics":["deep-learning","game","game-engine","machine-learning","pygame","python","reinforcement-learning","tensorflow"],"latest_commit_sha":null,"homepage":"","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/jonghough.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}},"created_at":"2021-08-21T13:24:33.000Z","updated_at":"2021-08-21T13:37:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"c5705078-5fab-4153-91d0-eb5240f7c423","html_url":"https://github.com/jonghough/proton","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonghough%2Fproton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonghough%2Fproton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonghough%2Fproton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonghough%2Fproton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonghough","download_url":"https://codeload.github.com/jonghough/proton/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240974497,"owners_count":19887306,"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","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":["deep-learning","game","game-engine","machine-learning","pygame","python","reinforcement-learning","tensorflow"],"created_at":"2024-11-11T16:19:58.918Z","updated_at":"2025-10-23T22:57:36.260Z","avatar_url":"https://github.com/jonghough.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![logo](proton.png)\n\n# Proton Project\n\n## Simple 2D game Engine and Reinforcement Learning System\n\nThis project contains the following\n\n* a simple 2D game engine, based around the `PyGame` library.\n* Q-Learning system for adding reinforcement learning to games.\n* several sample games, with some reinforcement learning examples, and `Tensorflow` models, demonstrating the game AI.\n* the main  learning source code originally evolved from the book *Hands-On Machine Learning with Scikit-Learn and TensorFlow*, which was modified for TensorFlow 2.\n\n### Machine learning libraries used\nTensorflow 2, Keras, Python 3.8\n\n## How to launch\n\nUsing the `requirements.txt` file, use\n\n```\nconda create --name \u003cenv_name\u003e --file requirements.txt\n```\n\n### run\n\n```\npython launcher.py --game \u003cPATH_TO_GAME_CONFIG.yml\u003e\n```\n\n#### example\n\n```\npython launcher.py --game ./games/othello/resources/game4.yml\n```\n \n### Sample Games\n\n#### Asteroid Dodge\nA spaceship can move horizontally to dodge the falling asteroids. This is perhaps the simplest demo game to develop a Q-Learning based AI.\n\n![logo](asteroid-gif-01.gif)\n\n#### Othello\nOthello game (also called Reversi). Tricky to develop Q-Learning based AI for. Work in progress.\n\n![logo](othello-gif-01.gif)\n\n## Project Structure\n```\n┌ proton - main source code for the game engine\n|\n├ tests - a few tests (not many!)\n|\n├ games - games\n    ├ asteroiddodge - source code for asteroid dodge game\n    |    ├ resources - contains the TF models, Learing parameter files, image files etc\n    | \n    ├ othello - source code for othello game\n    |    ├ resources - contains the TF models, Learing parameter files, image files etc\n    |\n    ├ piratedefense - source code for a terrible demo game\n\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonghough%2Fproton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonghough%2Fproton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonghough%2Fproton/lists"}