| --- |
| license: gpl-3.0 |
| tags: |
| - chess |
| - nnue |
| - uci |
| --- |
| |
| # GaiaChess NNUE networks |
|
|
| Neural networks (NNUE) for the [GaiaChess](https://github.com/jromang/gaiachess) UCI chess engine. |
|
|
| **Architecture (GaiaNet)**: 12 king buckets × 768 PST + filtered threat features (~41K inputs) → 640 → CReLU + pairwise → 16 → 32 → 1, with 8 output buckets. Trained with [Bullet](https://github.com/jw1912/bullet) on self-play data. |
|
|
| Files are append-only: a network file, once published, is never modified — engine releases pin an exact file name. |
|
|
| ## Networks |
|
|
| | File | Engine version | Notes | |
| |------|----------------|-------| |
| | `gaianet-t1-1000.bin` | never shipped | archived for reproducibility: this network generated part of the training data used by its successors | |
| | `gaianet-t2-1000.bin` | 4.2.0 – 4.2.5 | previous default network | |
| | `gaianet-t3b-1000.bin` | unreleased | +12.0 ±9.5 Elo vs t2 (SPRT, 2588 games) | |
| | `gaianet-t3e-1100.bin` | unreleased (default in `main`) | current default network: t3b fine-tuned for 100 more superbatches at lr/10 | |
|
|
| ## Usage |
|
|
| Networks are embedded into the engine at build time: |
|
|
| ```bash |
| curl -L -o nets/gaianet-t3e-1100.bin \ |
| "https://huggingface.co/jromanghf/gaiachess-networks/resolve/main/gaianet-t3e-1100.bin" |
| MODEL=nets/gaianet-t3e-1100.bin RUSTFLAGS="-C target-cpu=native" \ |
| cargo build --release --features nnue |
| ``` |
|
|
| Or loaded at runtime through UCI: `setoption name EvalFile value <path>`. |
|
|
| ## License |
|
|
| GPL-3.0-or-later, same as the engine. |
|
|
