chess-variant 1.0.0

A Python API wrapper for Fairyground Variant Challenge.

Chess Variant Python API Wrapper

A simple Python wrapper around the Fairyground Variant Challenge API.

Installation

pip install chess-variant

Usage

from chess_variant import ChessVariantAPI

api = ChessVariantAPI()

# 1. Get all supported chess variants
variants = api.get_variants()
print("Supported Variants:", list(variants['variants'].keys())[:5])

# 2. Create a new game room
game_info = api.create_game(variant="crazyhouse", white="Alice", time_control="3+2")
room_id = game_info['roomId']
print(f"Created game! Game URL: {game_info['gameUrl']}")

# 3. Get the state of the game
state = api.get_game(room_id)
print("Current FEN:", state['fen'])

# 4. Generate PGN
pgn = api.get_pgn(room_id)
print(pgn)

# 5. Check all active rooms
active_rooms = api.get_active_rooms()
print(f"Currently {active_rooms['count']} active rooms.")

Available Methods

• get_variants()
• create_game(variant="chess", white="White", time_control="5+5")
• get_game(room_id)
• get_game_result(room_id)
• get_moves(room_id)
• get_fen(room_id)
• get_pgn(room_id)
• get_active_rooms()
• get_all_rooms()