{"id":21486241,"url":"https://github.com/hardcode3/pychess","last_synced_at":"2025-03-17T10:11:40.209Z","repository":{"id":63201559,"uuid":"565976276","full_name":"Hardcode3/PyChess","owner":"Hardcode3","description":"A simple python chess wrapper for the stockfish engine","archived":false,"fork":false,"pushed_at":"2023-01-07T13:04:07.000Z","size":29506,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T19:38:50.623Z","etag":null,"topics":[],"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/Hardcode3.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}},"created_at":"2022-11-14T18:07:29.000Z","updated_at":"2023-05-24T15:50:30.000Z","dependencies_parsed_at":"2023-02-07T05:43:30.386Z","dependency_job_id":null,"html_url":"https://github.com/Hardcode3/PyChess","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/Hardcode3%2FPyChess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hardcode3%2FPyChess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hardcode3%2FPyChess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hardcode3%2FPyChess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hardcode3","download_url":"https://codeload.github.com/Hardcode3/PyChess/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244014135,"owners_count":20383715,"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":[],"created_at":"2024-11-23T13:20:03.506Z","updated_at":"2025-03-17T10:11:40.175Z","avatar_url":"https://github.com/Hardcode3.png","language":"Python","readme":"# PythonChess\n![size](https://img.shields.io/github/repo-size/Hardcode3/PyChess) \n![licence](https://img.shields.io/github/license/Hardcode3/PyChess)\n![python version](https://img.shields.io/badge/python-v3.10-blue)\n![os support](https://img.shields.io/badge/Windows|Linux|MacOS-blue)\n\nA pygame wrapper for the [stockfish chess engine](https://stockfishchess.org).\nFor more details, check their [GitHub repository](https://github.com/official-stockfish/Stockfish).\nThe wrapper is based on the python package [stockfish](https://github.com/zhelyabuzhsky/stockfish.git).\nThe view is developped using my pygame-toolkit, helping to create gui-like views in pygame.\n\n# Cloning\nStockfish is not cloned as a submodule, clone it as follows:\n```\ngit clone https://github.com/Hardcode3/PyChess.git\n```\nThe content of the repository corresponding to the official realease is located under the [chess/external/stockfish path](chess/external/stockfish/).\nConsider checking their [website](https://stockfishchess.org).\n\n# Launching the app\nTo run the app, create a virtual environment or pip install the [requirements](requirements.txt).\n## To create and activate a virtual environment on UNIX like systems\n```\npython3 -m venv venv\nsource venv/bin/activate\n```\n## To create and activate a virtual environment on Windows systems\n```\npython3 -m venv venv\n.\\venv\\Scripts\\activate\n```\n## To install the dependencies\n```\npip install -r requirements.txt\n```\n\nIf the [requirements.txt](requirements.txt) installation process fails, then try to install pygame in the virtual environment using the last dev version by manually typing:\nThe version used in the requirements file is indeed not compatible with python 3.11, but the dev version fixes the problem.\n\n```\npip install pygame --pre\n```\n\nAfter this step, pip should have installed the dependencies and you should be able to launch the main program using:\n```\npython3 main.py\n```\nNote that the [main.py](main.py) file handles the compilation of the [Stockfish](https://stockfishchess.org) code for UNIX systems. For windows systems, it downloads the latest binaries and extract it.\nIf a stockfish executable is found, skips the compilation process, otherwise compiles and download necessary files using the included [Makefile](chess/external/stockfish/src/Makefile).\nThe game launches automatically after the process is done.\n\n# Compatibility\nThis version is compatible with UNIX systems and now with Windows ones.\nJust launch the main file and python does it for you.\n[Stockfish for python](https://pypi.org/project/stockfish/) uses the compiled executable file available in [chess/external/src/](chess/external/src) as stockfish).\n\n# Screenshots\n![Main menu](assets/screenshots/main_menu.png)\n![The game itself](assets/screenshots/game.png)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhardcode3%2Fpychess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhardcode3%2Fpychess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhardcode3%2Fpychess/lists"}