{"id":23997627,"url":"https://github.com/siva-tanikonda/asteroids-plus","last_synced_at":"2025-08-23T03:06:17.517Z","repository":{"id":154011000,"uuid":"549083752","full_name":"siva-tanikonda/asteroids-plus","owner":"siva-tanikonda","description":"An HTML5 remake, an AI, and a training environment/framework for Asteroids (a retro Atari game)","archived":false,"fork":false,"pushed_at":"2025-01-03T01:13:54.000Z","size":16658,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T20:57:35.344Z","etag":null,"topics":["asteroids-game","cpp","genetic-algorithms","html-css-javascript","sdl2"],"latest_commit_sha":null,"homepage":"https://siva-tanikonda.github.io/asteroids-plus/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siva-tanikonda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2022-10-10T16:42:02.000Z","updated_at":"2025-01-03T01:14:07.000Z","dependencies_parsed_at":"2025-04-14T20:53:04.897Z","dependency_job_id":"30598b71-d7ec-4ee1-9818-2d6cf5952abf","html_url":"https://github.com/siva-tanikonda/asteroids-plus","commit_stats":null,"previous_names":["siva-tanikonda/asteroids-plus","siva-tanikonda/asteroids-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/siva-tanikonda/asteroids-plus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siva-tanikonda%2Fasteroids-plus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siva-tanikonda%2Fasteroids-plus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siva-tanikonda%2Fasteroids-plus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siva-tanikonda%2Fasteroids-plus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siva-tanikonda","download_url":"https://codeload.github.com/siva-tanikonda/asteroids-plus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siva-tanikonda%2Fasteroids-plus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271736904,"owners_count":24812006,"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-08-23T02:00:09.327Z","response_time":69,"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":["asteroids-game","cpp","genetic-algorithms","html-css-javascript","sdl2"],"created_at":"2025-01-07T22:57:38.270Z","updated_at":"2025-08-23T03:06:17.494Z","avatar_url":"https://github.com/siva-tanikonda.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Asteroids+\r\n## How to Use\r\n### Play Game/View AI\r\nYou can play the game for yourself and see the observe an AI trained by the algorithm at [siva-tanikonda.github.io/asteroids-plus](https://siva-tanikonda.github.io/asteroids-plus/).\r\n\r\n*Note: The amount of asteroids on-screen scales with the resolution of the game window, so your results may vary from the training results. In addition, the game-speed variable doesn't change the rate at which the AI updates its decision, which is intentional and is another way of stress-testing the AI.*\r\n### Using the Trainer\r\n#### Install Packages\r\nYou need to install C++, SDL2, and the nlohmann JSON library\r\n#### Run Trainer\r\n* First, you should alter any parameters you want to in *asteroids-plus/Training/config.json*.\r\n* Then, to run the trainer, execute the following command (in the *Training* directory):\r\n  ```\r\n  $ make train\r\n  ```\r\n* To monitor the progress of the training, use the window that has now popped-up.\r\n\r\n## AI Strategy \u0026 Training Methodology\r\nA complete overview of the project (including the AI strategy and training methodology) can be found in the Wiki: https://github.com/siva-tanikonda/asteroids-plus/wiki.\r\n\r\n## Tools/Libraries Used\r\n### SDL\r\nThis is a JavaScript runtime environment you can learn more about at [libsdl.org](https://www.libsdl.org/).\r\n### nlohmann/json\r\nThis is a library to parse JSON in C++ [github.com/nlohmann/json](https://github.com/nlohmann/json/).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiva-tanikonda%2Fasteroids-plus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiva-tanikonda%2Fasteroids-plus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiva-tanikonda%2Fasteroids-plus/lists"}