official-stockfish/fishtest

The Stockfish testing framework

352

stars

3,092

commits

Python

primary language

Sep 8, 2026

updated

tests.stockfishchess.org/tests

README

Overview

CI server CI worker posix CI worker msys2 CI lint

Fishtest is a distributed task queue for testing chess engines. The main instance for testing the chess engine Stockfish is at this web page https://tests.stockfishchess.org

Developers submit patches with new ideas and improvements, CPU contributors install a fishtest worker on their computers to play some chess games in the background to help the developers testing the patches.

The fishtest worker:

  • Automatically connects to the server to download a chess opening book, the fastchess chess game manager sources and the chess engine sources (both for the current Stockfish and for the patch with the new idea). The sources will be compiled according to the type of the worker platform.
  • Starts a batch of games using fastchess.
  • Uploads the games results on the server.

The fishtest server:

  • Manages the queue of the tests with customizable priorities.
  • Computes several probabilistic values from the game results sent by the workers.
  • Updates and publishes the results of ongoing tests.
  • Knows how to stop tests when they are statistically significant and publishes the final tests results.

To get more information, such as the worker/server install and configuration instructions, visit the Fishtest Wiki.

Contributors

(top 30 of 51)

ppigazzini

821 commits

glinscott

728 commits

vdbergh

511 commits

mcostalba

302 commits

official-stockfish/fishtest

The Stockfish testing framework

352

stars

3,092

commits

Python

primary language

Sep 8, 2026

updated

tests.stockfishchess.org/tests

README

Overview

CI server CI worker posix CI worker msys2 CI lint

Fishtest is a distributed task queue for testing chess engines. The main instance for testing the chess engine Stockfish is at this web page https://tests.stockfishchess.org

Developers submit patches with new ideas and improvements, CPU contributors install a fishtest worker on their computers to play some chess games in the background to help the developers testing the patches.

The fishtest worker:

  • Automatically connects to the server to download a chess opening book, the fastchess chess game manager sources and the chess engine sources (both for the current Stockfish and for the patch with the new idea). The sources will be compiled according to the type of the worker platform.
  • Starts a batch of games using fastchess.
  • Uploads the games results on the server.

The fishtest server:

  • Manages the queue of the tests with customizable priorities.
  • Computes several probabilistic values from the game results sent by the workers.
  • Updates and publishes the results of ongoing tests.
  • Knows how to stop tests when they are statistically significant and publishes the final tests results.

To get more information, such as the worker/server install and configuration instructions, visit the Fishtest Wiki.

Contributors

(top 30 of 51)

ppigazzini

821 commits

glinscott

728 commits

vdbergh

511 commits

mcostalba

302 commits

Languages

Python

85.8%

Jinja

8.8%

JavaScript

3.6%

CSS

1.7%