A look at lichess-org/fishnet: 942 stars on GitHub, written primarily in Rust. Distributed Stockfish analysis for lichess.org
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
./fishnet configure # Rerun config dialog
./fishnet systemd --auto-update # Print a .service file
./fishnet --help # List commands and options
Other installation methods:
From source,
Docker,
Kubernetes,
OpenShift
Pick an update strategy.
Automatic updates
Run with --auto-update as recommended above.
Subscribe to release announcements
With a GitHub account, you can watch this repository (can be set to
release announcements only). See the top right corner on this page.
Video introduction
Watch @arex explain fishnet.
FAQ
Which engine does fishnet use?
fishnet uses Stockfish
(hence the name) and Fairy-Stockfish
for chess variants.
What are the requirements?
Available for
64-bit Intel and AMD
ARMv8 / Silicon
Linux
x86_64-unknown-linux-musl
aarch64-unknown-linux-musl
Windows
x86_64-pc-windows-gnu.exe
macOS
x86_64-apple-darwin
aarch64-apple-darwin
FreeBSD
build from source
Needs Linux or an operating system from around 2019 or later
Will max out the configured number of 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, IPv4 not required)
Is my CPU fast enough?
Almost all processors will be able to meet the requirement of ~2 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).
Why does my client remain idle?
Your client may remain idle if fishnet estimates that another client would
be able to complete the next batch more quickly, or if the client has been
configured to join the queue only if a backlog is building up. By standing
by, you're still contributing to reliability by providing redundancy, and also
to the potential maximum throughput in case requests peak.
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 batches it has already started. On immediate shutdown,
the client tries to inform Lichess that batches should be reassigned.
If even that fails, Lichess will reassign the batches 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.
Why do I need a key?
The key allows us to trace provided analysis back to your Lichess account.
You can use a single key to run multiple instances.
You do not need to request a key (nor our permission) to run private instances.
Is fishnet secure?
To the best of our knowledge. All engine input is carefully validated.
Note that you implicitly trust the authors and the GitHub and Amazon S3
infrastructure when running with --auto-update. You can mitigate this by
running fishnet as an unprivileged user.
cargo-crev is used to review the
trustworthiness of dependencies.
cargo-auditable
is used to embed dependency meta data into binaries.
Is there a leaderboard of contributors?
No, sorry, not publicly. It would incentivize gaming the metrics.
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.
Also supports SSLKEYLOGFILE for inspection at runtime.
License
fishnet is licensed under the GPLv3+. See LICENSE.txt or ./fishnet license
for the full license text.
Yes — lichess-org/fishnet ships under the GPL-3.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/lichess-org/fishnet.
What is lichess-org/fishnet?
lichess-org/fishnet (lichess-org/fishnet) is a Rust project on GitHub. From the project's own README: Distributed Stockfish analysis for lichess.org
Where do I read more about lichess-org/fishnet?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/lichess-org/fishnet is the definitive source.
Read full README in the tab above.
Curious whether fishnet is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about fishnet.