A Rust library for chess and chess variant rules and operations

crates.io docs.rs

• Generate legal moves:

  use shakmaty::{Chess, Position};
  let pos = Chess::default();
  let legals = pos.legal_moves();
  assert_eq!(legals.len(), 20);

• Play moves:

  use shakmaty::{Square, Move, Role};
  // 1. e4
  let pos = pos.play(&Move::Normal {
   role: Role::Pawn,
   from: Square::E2,
   to: Square::E4,
   capture: None,
   promotion: None,
  })?;

• Detect game end conditions: pos.is_checkmate(), pos.is_stalemate(), pos.is_insufficient_material(), pos.outcome().

• Read and write FEN, SAN and UCI notation.

• Supports all Lichess variants: Standard chess, Chess960, Antichess, Atomic, King of the Hill, Three-Check, Crazyhouse, Racing Kings and Horde. Provides vocabulary to implement other variants.

• Bitboards and compact fixed shift magic attack tables.

• Fast compact binary encodings for positions and moves.

• Zobrist hash positions.

• Probe Syzygy tablebases with shakmaty-syzygy.

• Parse PGN files with pgn-reader (experimental).

• shakmaty
• shakmaty-syzygy
• pgn-reader

Expect move generation performance in the ballpark of the world's best chess engines.

Simple perft speed can give a rough indication, but only that -- for example, Stockfish maintains additional data structures for evaluation (and newer Stockfish versions put even less emphasis on perft speed).

Here is a snapshot at a point in time. No hashtables. i7-6850K CPU @ 3.60GHz.

shakmaty is licensed under the GPL-3.0 (or any later version at your option). See the COPYING file for the full license text.