Note: Its ai coded ELO: 1

Un motor de ajedrez escrito en Rust, con red neuronal NNUE propia — nacido sin saber ni mover un peón en código, y ahora juega solo, piensa solo, y a veces sacrifica piezas sin avisar.

No es Stockfish. No pretende serlo. Pero pelea.

• 🧠 Evaluación híbrida: clásica + red neuronal NNUE
• ⚡ Búsqueda negamax con poda alfa-beta, tabla de transposición, quiescence search
• 🎮 Protocolo UCI — funciona con cualquier interfaz gráfica de ajedrez
• 🤖 Juega en vivo en Lichess

1. Clona el repo.
2. Compílalo:

   cargo build --release

3. Ábrelo con cualquier interfaz UCI (Arena, CuteChess, BanksiaGUI...) o directo por terminal:

   ./target/release/mittens
   uci

4. Escribe go y reza.

Mittens no explica sus jugadas. No pide perdón por los sacrificios que no calculó bien. Simplemente juega — y a veces, sin querer, hace algo brillante.

¿Le ganas? Cuéntanoslo. ¿Te gana? También cuéntanoslo, mejor con captura de pantalla.

Si te gusta el proyecto, una ⭐ ayuda mucho a que más gente lo descubra.

Mittens corre en Android via un puente JNI (src/jni_bridge.rs), probado en un celular real (arm64-v8a, Android 16): handshake UCI, carga de la NNUE completa, búsqueda multi-hilo y stop funcionando dentro del runtime ART.

Las librerías nativas ya compiladas para las 3 ABIs (arm64-v8a, armeabi-v7a, x86_64) estan en android-jnilibs/, listas para copiar a app/src/main/jniLibs/ de cualquier proyecto Android (minSdk 24+).

Guia completa de integracion (clase Kotlin exacta, como cargar los pesos NNUE, advertencias de threading, y que se verifico realmente): ANDROID_JNI_README.md.

Requiere Rust con soporte para edition 2024.

cd mi-motor-rust-produccion
cargo build --release

El ejecutable quedara en:

target/release/mittens

Pruebas recomendadas antes de conectarlo al bot:

cargo fmt --check
cargo check
cargo test
cargo run --release -- perft
cargo run --release -- matetest
cargo run --release -- seetest
cargo run --release -- repetitiontest

La suite perft completa llega a profundidades altas y puede tardar. Para una prueba corta:

cargo test perft_inicio_hasta_tres

Opciones principales:

• Hash: memoria aproximada de la tabla de transposicion en MiB.
• Clear Hash: borra la tabla de transposicion.
• Move Overhead: margen en milisegundos para GUI, red y sistema operativo.
• Threads: hilos de Lazy SMP.
• Personalidad: tal o universal.
• BookPath y OwnBook: libro Polyglot. El libro performance.bin va embebido en el ejecutable pero APAGADO por defecto (OwnBook es default false): el motor busca normalmente desde la jugada 1 salvo que se active con setoption name OwnBook value true (o MITTENS_CON_LIBRO=1). Un BookPath explicito sustituye al libro embebido.
• SyzygyPath: tablas de finales.
• UseNNUE: activado por defecto. La red va EMBEBIDA en el ejecutable (pesos_bullet_1024_buckets8.bin, formato bullet 768 -> 1024x2 -> 1 SCReLU con 8 output buckets), asi que el motor evalua con NNUE sin necesidad de configurar nada ni de que el .bin viaje junto al binario. Antes el valor por defecto era false con NNUEPath vacio: cualquier tester que no configurara la ruta hacia jugar al motor con evaluacion clasica pura, mucho mas debil.
• NNUEPath: opcional, solo para reemplazar la red embebida por otra.

Ejemplo de red alternativa (ruta relativa a esta carpeta):

setoption name NNUEPath value pesos_bullet_1024_buckets8.bin
setoption name UseNNUE value true

Una carga fallida ya no borra una red valida que estuviera cargada. El motor muestra un checksum al aceptar los pesos.

./mover_fen_rust.sh "FEN" 5000

Variables opcionales:

MITTENS_BIN=/ruta/al/motor MITTENS_HILOS=4 ./mover_fen_rust.sh "FEN" 5000

LMR queda activado salvo que se defina expresamente MITTENS_LMR=0.

• pesos_bullet_1024_buckets8.bin: pesos de la red NNUE ACTUAL en produccion (formato bullet, 768 -> 1024x2 -> 1 SCReLU, 8 output buckets). Va embebida en el ejecutable via include_bytes! desde src/neural.rs.
• pesos_amenazas_prueba.bin: fixture histórico de la red Bullet de 512 neuronas usado por scripts antiguos; no es la red de 1024 embebida actual.
• pesos_v1.bin: fixture de la arquitectura VIEJA (770 entradas, 770 -> 256 -> 32 -> 1), conservado solo porque dos tests unitarios en src/neural.rs (rechaza_nan_sin_panico, checksum_es_estable) lo usan via include_bytes! para probar el validador de bytes -- no representa la red que juega hoy.
• performance.bin: libro de aperturas Polyglot (1.487.264 bytes = 92.954 entradas, 77.872 posiciones unicas). Va EMBEBIDO en el ejecutable via include_bytes! (src/polyglot.rs), pero apagado por defecto: se instala en la primera busqueda solo si OwnBook esta en true. Antes era codigo muerto: solo se cargaba si alguien pasaba MITTENS_BOOK_PATH o setoption name BookPath, asi que en la practica el motor jugaba siempre sin libro. Auditado en la rama ronda4_libro: el repertorio es sano (mediana -4 cp a depth 16, ninguna linea peor que -1.00) y con el libro encendido marco 56.2% en 160 partidas a 150 ms contra el mismo motor sin libro.

cargo test --release --locked ejecuta las pruebas unitarias y del protocolo UCI, incluidas las regresiones de mate en el límite de 50 movimientos, ahogado y combinaciones de profundidad, reloj y searchmoves. Los duelos H2H y las sondas que requieren otros motores están marcados ignore; se ejecutan expresamente con cargo test --release --test h2h_mittens_vs_termino -- --ignored --nocapture (o el nombre de la integración correspondiente), con los binarios externos disponibles. Las pruebas de los acumuladores incluyen recorridos aleatorios comparando la actualización incremental con el recálculo completo. El manifiesto MANIFEST_SHA256.txt se regenera con shasum -a 256 * src/* > MANIFEST_SHA256.txt cada vez que cambia el codigo o los pesos -- si no coincide con los archivos actuales, es que el proyecto se modifico despues de la ultima regeneracion, no necesariamente que este corrupto. Vibecoded

La NNUE Bullet usa AVX2 de 256 bits para actualizar acumuladores, calcular SCReLU y fusionar actualización y evaluación cuando AVX2 está habilitado al compilar. Las compilaciones portables x86-64 conservan SSE2; ARM conserva NEON.

En un Windows con Rust MSVC y las herramientas de C++ instaladas:

$env:RUSTFLAGS = "-C target-cpu=znver3 -C target-feature=+avx2"
cargo build --release --locked --features tournament --target x86_64-pc-windows-msvc --bin mittens

znver3 orienta el código a Zen 3, base usada por el compilador para el 6900HX (Zen 3+). La feature tournament fija Contempt a 0 por defecto. Sin esa feature se conserva el valor histórico 200; ahora puede ajustarse por UCI. Las compilaciones de torneo se identifican en UCI como Mittens CEDR Windows, Mittens CEDR Linux o Mittens CEDR macOS, según el sistema. La NNUE embebida permanece activada por defecto (UseNNUE=true).

Ajustes del torneo: Threads=4, Hash=2048, Contempt=0, OwnBook=false. Configurar 3 minutos + 3 segundos y Perfect 2021 en la GUI. Para tablas Syzygy de hasta 5 piezas, indicar la carpeta en SyzygyPath.

Las pruebas de AVX2 comparan los resultados con el cálculo escalar exacto, incluidos pesos extremos y actualizaciones incrementales. La emulación verifica corrección; la velocidad debe medirse en el Ryzen real.

The ccrl feature provides the tournament preset: UCI name Mittens CCRL Windows or Mittens CCRL Linux, Hash=256 MiB, Threads=1, Contempt=0, OwnBook=false and UseNNUE=true at startup. The environment variable MITTENS_CON_LIBRO=1 does not enable the book in this preset. The GUI can still configure options through UCI. The 1024-neuron, 8-output-bucket NNUE is embedded in the executable and enabled by default.

Two CPU variants are available:

Choose Portable when unsure which CPU extensions are available. The optimized variant uses the generic x86-64-v3 target, which includes AVX2, BMI1/BMI2, F16C, FMA, LZCNT, MOVBE, POPCNT and the preceding x86-64 feature levels. Both variants use the same source, network, settings and UCI name.

Example Linux builds (musl target and linker must be installed):

RUSTFLAGS="-C target-cpu=x86-64" \
cargo build --release --locked --features ccrl --target x86_64-unknown-linux-musl --bin mittens

RUSTFLAGS="-C target-cpu=x86-64-v3" \
cargo build --release --locked --features ccrl,intel-bmi2 --target x86_64-unknown-linux-musl --bin mittens

For Windows PowerShell with a configured MinGW toolchain:

$env:RUSTFLAGS = "-C target-cpu=x86-64"
cargo build --release --locked --features ccrl --target x86_64-pc-windows-gnu --bin mittens

$env:RUSTFLAGS = "-C target-cpu=x86-64-v3"
cargo build --release --locked --features ccrl,intel-bmi2 --target x86_64-pc-windows-gnu --bin mittens

The internal feature name intel-bmi2 enables PEXT whenever the x86-64 build also enables BMI2. It is not a CPU-brand check. The attack table is built in PEXT order and exhaustively compared against independent ray casting. Other builds retain magic bitboards. The NNUE uses integer arithmetic; no speedup is attributed to unused floating-point instructions. AVX-512, VNNI and AMX are not enabled.

The portable x86-64 build fuses common accumulator updates with SCReLU and output evaluation, using SSE2 PADDW/PSUBW, PMULLW and PMADDWD instructions. It consumes updated neurons directly from registers while storing the child accumulator, avoiding a separate copy and output pass. Integer results remain exact: the two perspectives are reduced separately into i64. Null moves and less common update shapes retain the general fallback. The AVX2 and NEON paths remain available on their respective targets. No different network or additional CPU extensions are required for the SSE2 path.

Configure a REPEATING time control of 40 moves in 15 minutes, calibrated for the tester's machine using Stockfish 10 as specified by CCRL. Pondering OFF, OwnBook=false, book and position learning OFF. Use the same generic book for all engines, with at most 12 moves per side. Set 256 or 512 MiB of search hash per single-CPU engine; for a 4-CPU entry, up to four times that amount. The operator selects Threads=1 or Threads=4.

Provide external Syzygy tables through SyzygyPath; no tablebases or opening book are included. There is no separate EGTB hash option: search Hash does not replace the 32/64 MiB EGTB setting in the CCRL conditions. Coordinate that requirement with the tester/controller. A package does not imply CCRL acceptance.

References:

• PEXT/BMI2 in Rust
• SSE2 PMADDWD
• CCRL 40/15 conditions