Need help with nibbler?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

fohristiwhirl
170 Stars 24 Forks GNU General Public License v3.0 2.5K Commits 11 Opened issues

Description

Nibbler - Leela Chess Zero (Lc0) interface

Services available

!
?

Need anything else?

Contributors list

# 191,120
Electro...
macOS
Windows
board-g...
2382 commits
# 256,028
Shell
C
OCaml
static-...
1 commit

Nibbler

"By far the best ICCF analysis tool for Leela." — jhorthos

Nibbler is a real-time analysis GUI for Leela Chess Zero (Lc0), which runs Leela in the background and constantly displays opinions about the current position. You can also compel the engine to evaluate one or more specific moves. Nibbler is loosely inspired by Lizzie and Sabaki.

For prebuilt binary releases, see the Releases section. For help, the Discord may be your best bet, or open an issue here.

Screenshot

Features

  • Display Leela's top choices graphically.
  • Winrate graph.
  • Optionally shows Leela statistics like N, P, Q, S, U, V, and WDL for each move.
  • UCI
    searchmoves
    functionality.
  • Automatic full-game analysis.
  • Play against Leela from any position.
  • Leela self-play from any position.
  • PGN loading via menu, clipboard, or drag-and-drop.
  • Supports PGN variations of arbitrary depth.
  • FEN loading.
  • Chess 960.

Installation - the simple way

Some Windows and Linux standalone releases are uploaded to the Releases section from time to time. Mac builds are harder to make but @twoplan is experimenting with it in this repo.

Installation - the hard way

Running Nibbler from source requires Electron, but has no other dependencies. If you have Electron installed (e.g.

npm install -g electron
) you can likely enter the
/src
directory, then do
electron .
to run it. Nibbler should be compatible with at least version 5 and above.

Aesthetic adjustments

As well as the menu options, various aesthetic adjustments are possible in the

config.json
file, which can be found via the Dev menu. For example, board colour can be changed.

If you like a different piece set, you can create a folder of

.png
or
.svg
files with the right names and point the
override_piece_directory
config option to it.

Advanced engine options

Most people won't need them, but all of Leela's engine options can be set in two ways:

  • Leela automatically loads options from a file called
    lc0.config
    at startup - see here.
  • Nibbler will send UCI options specified in Nibbler's own
    config.json
    file (which you can find via the Dev menu).

Hints and tips

An option to enable the UCI

searchmoves
feature is available in the Analysis menu. Once enabled, one or more moves can be specified as moves to focus on; Leela will ignore other moves. This is useful when you think Leela isn't giving a certain move enough attention.

Leela forgets much of the evaluation if the position changes. To mitigate this, an option in the Analysis menu allows you to hover over a PV (on the right) and see it play out on the board, without changing the position we're actually analysing. You might prefer to halt Leela while doing this, so that the PVs don't change while you're looking at them.

Leela running out of RAM can be a problem if searches go on too long. You might like to set a reasonable node limit (in the Engine menu), perhaps 10 million or so.

Note that other UCI engines should run OK if they support Chess960 castling format, but the results will be poor because we use

MultiPV
, which cripples traditional A/B engines.

Thanks

Thanks to everyone in Discord and GitHub who's offered advice and suggestions; and thanks to all Lc0 devs and GPU-hours contributors!

The pieces are from Lichess.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.