{"id":13822177,"url":"https://github.com/marcizhu/readme-chess","last_synced_at":"2026-04-05T01:37:14.437Z","repository":{"id":115142260,"uuid":"322593341","full_name":"marcizhu/readme-chess","owner":"marcizhu","description":"♟️ Play Multiplayer Chess in a README file!","archived":false,"fork":false,"pushed_at":"2024-02-02T12:50:00.000Z","size":494,"stargazers_count":95,"open_issues_count":1,"forks_count":15,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-16T15:44:35.597Z","etag":null,"topics":["chess","game","games","github-workflows","python-chess","readme-chess","readme-games"],"latest_commit_sha":null,"homepage":"https://github.com/marcizhu","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/marcizhu.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":"2020-12-18T12:47:22.000Z","updated_at":"2025-05-11T13:12:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"92bc767c-526d-4f30-96be-59a40490cf80","html_url":"https://github.com/marcizhu/readme-chess","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/marcizhu/readme-chess","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcizhu%2Freadme-chess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcizhu%2Freadme-chess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcizhu%2Freadme-chess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcizhu%2Freadme-chess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcizhu","download_url":"https://codeload.github.com/marcizhu/readme-chess/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcizhu%2Freadme-chess/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31421869,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T00:25:07.052Z","status":"ssl_error","status_checked_at":"2026-04-05T00:25:05.923Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["chess","game","games","github-workflows","python-chess","readme-chess","readme-games"],"created_at":"2024-08-04T08:01:47.101Z","updated_at":"2026-04-05T01:37:14.405Z","avatar_url":"https://github.com/marcizhu.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# GitHub README Chess Tournament\n\nThis template repository contains the source code for a Python Chess bot, together with GitHub Workflows in order to allow ANYONE to play chess from a README file. Want to see this in action? Go to my [profile page](https://github.com/marcizhu) and feel free to try it out by yourself!\n\n\n## Steps to make your own repo\n\n1. Create a new repository based on this template.\n\n2. (Optional) Tweak the bot settings to your linking. These settings are located in the file `data/settings.yaml`. You can leave them as they are if you don't want to change anything.\n\n3. Rename the folder `.github/_workflows` to `.github/workflows` in order to enable the GitHub Actions workflow that does all the magic.\n\n4. Delete this README file and make your own `README.md`. I recommend using `README.template` as a starting point. Keep in mind that the text between the HTML comments like `\u003c!-- BEGIN CHESS BOARD --\u003e` and `\u003c!-- END CHESS BOARD --\u003e` will be recreated after each move, so don't waste your time changing anything in there ;)\n\n5. Commit and push all the settings and create a new issue with title `Chess: Start new game` (case insensitive). If all goes well, after a few seconds a new response should appear telling you that a new game was successfully started and the issue should be automatically closed. After that, refresh your repository in order to see the changes done by the bot and your repository is ready to go! Just click on any of the links on the table of available moves, click on \"Submit new issue\" and after a few seconds, the move will be played!\n\nDon't forget to share, have fun and enjoy your games!\n\n\n## Some extra information\n\nAll games are automatically archived into the `games/` folder in PGN format. The current game is always called `games/current.pgn`, and the archived games always follow the pattern `games/game-yyyymmdd-HHMMSS.pgn`. You can download the archived games and review them using an external application. Each move in the PGN file has a comment specifying who performed each move so you can see which moves you played!\n\nFinally, if you find any problem, feel free to submit an issue or open a PR and I will be more than happy to take a look at it!\n\n\n## Credits\n\nThanks to [@timburgan](https://github.com/timburgan) for the initial idea. This project is heavily inspired on his. Also, big thanks to the authors and contributors of [python-chess](https://python-chess.readthedocs.io/en/latest/) and [PyGithub](https://pygithub.readthedocs.io/en/latest/). Without their libraries, this project would have been impossible :heart:\n\n\n## License\n\nThis template and the code in it is licensed under the [MIT License](https://github.com/marcizhu/readme-chess/LICENSE).  \nIf you use this on your own repositories, please add a link back to this repo :D\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcizhu%2Freadme-chess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcizhu%2Freadme-chess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcizhu%2Freadme-chess/lists"}