kriegspiel 1.3.1

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 now has its own convenience entrypoint:

from kriegspiel.wild16 import Wild16Game

wild16 = Wild16Game()
print(wild16.current_turn_pawn_tries)

Main Concepts

• BerkeleyGame: the referee and full hidden board state
• Wild16Game: Wild 16 convenience entrypoint over the shared hidden-board engine
• 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