spooky-chess 0.7.1

High-performance chess library with arbitrary board sizes

spooky_chess 🎃👻

Rust and Python library for the game of Chess.

Features

• Drive external engines with Universal Chess Interface.
• Variable board sizes.
• Relatively fast.
• Out-of-the-box support for DL/ML (action encoding and decoding methods).
• Consistent interface with spooky-connect4 and spooky-go.

Performance

Measured with a Threadripper 9980x, and 6400 MT/s CL36 DDR5. Python 3.14.

> cargo run --release
50000 random game playouts
  spooky_chess (Rust Bindings):
    moves:   4936906
    time:    2.27s
    moves/s: 2170269.40

> uv run python -m pytest -k test_compare_random_game_playout -s --run-slow
50000 random game playouts
  spooky_chess (Python Bindings):
    moves:   4936722
    time:    6.84s
    moves/s: 721542.27
  python-chess:
    moves:   4931439
    time:    113.83s
    moves/s: 43323.89
  Speedup: 16.64x

Validity

Fuzz-tested against python-chess, with 5 million random playouts.

Install

Rust

cargo add spooky_chess

Python

uv add spooky-chess

Includes type hints.

Examples

These examples load a PGN, and ask Stockfish for the best move at every playable position.

Rust:

cargo run --example analyse_pgn

Python:

uv run python examples/analyse_pgn.py

Develop

Tests

• fish run_tests.fish
  • fish run_python_tests.fish
  • fish run_rust_tests.fish

Lints

• fish run_lints.fish

Performance

• fish run_benchmark.fish
• fish run_profile.fish

See Also

• spooky-chess
• spooky-connect4
• spooky-go