fishnet: distributed Stockfish analysis for lichess.org

Installation

1. Request your personal fishnet key: https://lichess.org/get-fishnet

2. Install the fishnet client.

   Download standalone binary

   Not yet available for 2.x.

   From source

   Assuming you have a recent Rust toolchain installed:

   sh git clone --recursive https://github.com/niklasf/fishnet.git cd fishnet cargo install .

   Via Docker

   Not yet available for 2.x.

3. Run to donate CPU time:

   sh fishnet --auto-update

   Other useful commands:

   sh fishnet configure # Rerun the configuration dialog fishnet systemd # Generate a systemd service file fishnet --help # List all commands and options

Video tutorial (outdated since 2.x)

FAQ

Which engine does fishnet use?

fishnet uses Stockfish 12 (hence the name) and a fork of Stockfish with multi-variant support.

Precompiled builds for various CPU models come bundled with fishnet. To get another architecture included, all we need is a reproducible build process (so everyone can verify that the compiled binary matches the source).

What are the requirements?

• Precompiled Stockfish binaries available for Linux, Windows, and OS X on Intel, AMD, and ARMv8 CPUs
• Will max out the number of configured CPU cores
• Uses about 64 MiB RAM per CPU core
• A small amount of disk space
• Low-bandwidth network communication with Lichess servers (only outgoing HTTP requests, so probably no firewall configuration required)

Is my CPU fast enough?

Almost all processors will be able to meet the requirement of 4 meganodes in 6 seconds. Clients on the faster end will automatically be assigned analysis jobs that have humans waiting for the result (the user queue, as opposed to the system queue for slower clients).

What happens if I stop my client?

Feel free to turn your client on and off at any time. By default, the client will try to finish any jobs it has already started. On immediate shutdown, the client tries to inform Lichess that jobs should be reassigned. If even that fails, Lichess will reassign the jobs after a timeout.

Will fishnet use my GPU?

No, Stockfish is a classical alpha-beta engine. The neural network evaluation of Stockfish NNUE works efficiently on CPUs.

Is fishnet secure?

To the best of our knowledge. However you implicitly trust the authors and the GitHub infrastructure when running with --auto-update.

You can mitigate this by running fishnet as an unprivileged user.

Stockfish builds are reproducible, so you can verify that the distributed binaries match the source.

Is there a leaderboard of contributors?

No, sorry, not publically. It would incentivize gaming the metrics.

Is there a Docker image?

Not yet available for fishnet 2.x.

Can I autoscale fishnet in the cloud?

There is currently no ready-made solution, but an API for monitoring the job queue status is provided.

Protocol

.

See protocol.md for details.

License

fishnet is licensed under the GPLv3+. See LICENSE.txt for the full license text.