{"id":17968725,"url":"https://github.com/disservin/fastchess","last_synced_at":"2025-04-05T11:06:00.605Z","repository":{"id":91235235,"uuid":"603127656","full_name":"Disservin/fastchess","owner":"Disservin","description":"fastchess is a chess cli tool to run engine vs engine matches","archived":false,"fork":false,"pushed_at":"2025-03-23T20:42:15.000Z","size":11116,"stargazers_count":110,"open_issues_count":12,"forks_count":24,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-29T10:05:13.726Z","etag":null,"topics":["chess","cli-app","cpp"],"latest_commit_sha":null,"homepage":"","language":"C++","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/Disservin.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":"2023-02-17T17:12:38.000Z","updated_at":"2025-03-24T16:37:06.000Z","dependencies_parsed_at":"2023-03-17T04:15:59.427Z","dependency_job_id":"f4634af7-ca06-441a-a284-c25c31185928","html_url":"https://github.com/Disservin/fastchess","commit_stats":null,"previous_names":["disservin/fastchess"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Disservin%2Ffastchess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Disservin%2Ffastchess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Disservin%2Ffastchess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Disservin%2Ffastchess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Disservin","download_url":"https://codeload.github.com/Disservin/fastchess/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325693,"owners_count":20920714,"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":["chess","cli-app","cpp"],"created_at":"2024-10-29T14:41:22.150Z","updated_at":"2025-04-05T11:06:00.599Z","avatar_url":"https://github.com/Disservin.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fastchess\n\n[![Fastchess](https://github.com/Disservin/fastchess/actions/workflows/fastchess.yml/badge.svg?branch=master)](https://github.com/Disservin/fastchess/actions/workflows/fastchess.yml)\n\nFastchess is a versatile command-line tool designed for running chess engine\ntournaments.  \nWritten primarily in C++17, it utilizes [doctest](https://github.com/doctest/doctest) as its testing\nframework.\n\nWith Fastchess, you can effortlessly orchestrate chess tournaments, configure\ntime controls, and execute matches concurrently for optimal time efficiency.\nExtensively tested for high concurrency (with up to 250 threads) and\nshort time controls (0.2+0.002s), it exhibits minimal timeout issues, with only\n10 matches out of 20,000 experiencing timeouts.\n\n## What's New\n\n- **Logging Changes**: Logs no longer include the engine output by default.\n  You can enable this feature by adding `engine=true` to\n  the log option.\n\n- **UCI Compliance Checker**: Fastchess now offers a built-in UCI compliance checker,  \n  allowing you to verify that engines adhere to the UCI protocol.  \n  To use this feature, simply run the following command:\n  `./fastchess --compliance ENGINE_PATH [ENGINE_ARGS]`\n- **Enhanced Cutechess Output**: The Cutechess output support has been refined to\n  enhance compatibility with other tools. Simply switch the `-output` option to\n  cutechess to enable it.\n- **Extended PGN Data**: You can now track nodes, seldepth, nps (nodes per\n  second), hashfull, tbhits, and time left in the PGN output. Refer to the `-pgnout`\n  option for detailed information.\n- **Quick Match Option**: We've introduced a `-quick` option for running quick\n  matches between two engines with a specified book. Specify\n  `-quick cmd=ENGINE1 cmd=ENGINE2 book=BOOK` to swiftly initiate a match.\n\n- **GZIP Compression for logs**: The logs can now be compressed using GZIP to\n  reduce disk space usage. You can enable this feature adding `ZLIB=true` to\n  the `make` command and the enabling the `compress=true` option for the log.\n  **Compiling with ZLIB=true will include _gzstream_ a wrapper for zlib from**  \n  **Deepak Bandyopadhyay and Lutz Kettner, which is licensed under LGPL.**\n\n## Quick start\n\n### Building from source\n\nBuilding Fastchess from source is straightforward. Just follow these steps:\n\n1. Clone the repository `git clone https://github.com/Disservin/fastchess.git`\n2. Navigate to the Fastchess directory `cd fastchess`\n3. Build the executable `make -j` for GCC and `make -j CXX=clang++` for Clang (requires GCC \u003e= 7.3.0 or Clang \u003e= 8.0.0).\n\nThe executable will be located in the root directory.\n\nIf you are on Linux, you can run `make install` to install the binary on your system.  \nBy default, the installation prefix is set to `/usr/local`. You can change this location by specifying the PREFIX during installation. The binary will be installed in `$(PREFIX)/bin`, and the man page will be installed in `$(PREFIX)/share/man/man1`.\n\n```bash\nmake install PREFIX=/custom/path\n```\n\nThis will install the binary in /custom/path/bin and the man page in /custom/path/share/man/man1. If PREFIX is not specified, it defaults to /usr/local.\n\n### Download the latest release\n\nPrefer a pre-compiled version?\n\nDownload the latest release from our [release page](https://github.com/Disservin/fastchess/releases).\n\nCurrent dev versions are available as artifacts from the [CI](https://github.com/Disservin/fastchess/actions?query=is%3Asuccess+event%3Apush+branch%3Amaster).\n\n### Example usage\n\nHere's an example of how to use Fastchess:\n\n```bash\nfastchess.exe -engine cmd=Engine1.exe name=Engine1 -engine cmd=Engine2.exe\nname=Engine2 -each tc=10+0.1 -rounds 200 -repeat -concurrency 4\n```\n\n_Note: It is highly encouraged to use an opening book._\n\n## Command line options\n\nSee [man.md](man.md) for a detailed description of all command line options.\n\n## Contributing\n\nWe welcome contributions to fastchess! Please ensure that any changes you make\nare **beneficial** to the development and **pass the CI tests**.\n\nThe code follows the Google style and is formatted with clang-format. When\ncreating pull requests, please format your code accordingly.\n\nTo contribute, you'll need a recent GCC compiler that supports C++17 and the\nability to run the Makefile. You can locally test your changes by running\n`make -j tests`, followed by executing the `./fastchess-tests` executable to\nverify your changes pass the tests.\n\nYou can format the code with clang-format by running `make format`.\nAfter making changes to the man file, you need to run `make update-man`.\n\n## Maintainers \u0026 contributors\n\nThe following people have push access to the repository:\n\n- [Disservin](https://github.com/Disservin)\n- [Szil](https://github.com/SzilBalazs)\n- [PGG106](https://github.com/PGG106)\n\nSpecial thanks to [gahtan-syarif](https://github.com/gahtan-syarif) for his many contributions and\nthorough testing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdisservin%2Ffastchess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdisservin%2Ffastchess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdisservin%2Ffastchess/lists"}