kriegspiel 1.3.0

Python hidden-information chess engine for Berkeley-family Kriegspiel variants

kriegspiel

Python game engine for Berkeley-family Kriegspiel referee rules.

Current scope:

• Berkeley Kriegspiel
• Berkeley + Any
• Wild 16

The package models the referee, not a UI. You interact with it by asking questions as KriegspielMove objects and reading KriegspielAnswer results.

Install

pip install kriegspiel

Quick Start

import chess

from kriegspiel.berkeley import BerkeleyGame
from kriegspiel.move import KriegspielMove, QuestionAnnouncement

game = BerkeleyGame(any_rule=True)

question = KriegspielMove(
    QuestionAnnouncement.COMMON,
    chess.Move.from_uci("e2e4"),
)
answer = game.ask_for(question)

print(answer.main_announcement)
print(answer.special_announcement)

game.save_game("game.json")
loaded = BerkeleyGame.load_game("game.json")

Wild 16 uses the same engine with an explicit ruleset:

wild16 = BerkeleyGame(ruleset="wild16")
print(wild16.current_turn_pawn_tries)

Main Concepts

• BerkeleyGame: the referee and full hidden board state
• KriegspielMove: a player question, either a normal move or ASK_ANY
• KriegspielAnswer: the referee response, including move outcome, captures, special announcements, and variant-specific public metadata

Links

• PyPI: kriegspiel
• Issues: github.com/Kriegspiel/ks-game/issues