chess-variant 1.0.3

A Python API wrapper for Fairyground Variant Challenge.

Chess Variant Python SDK

The absolute easiest way to create, view, and list chess variants via Python.

Powered by Fairyground Variant Challenge.

Installation

pip install chess-variant

Basic Usage

import chess_variant

# 1. Start a game instantly
game_url = chess_variant.play("3check")
print(f"Play your game here: {game_url}")

# 2. View board state/FEN ('123456' is the roomId)
state = chess_variant.view("123456")
print(f"Current FEN: {state['fen']}")

# 3. List all active game rooms
all_rooms = chess_variant.rooms()
print(f"Currently {len(all_rooms)} active games!")

# 4. Get the move list for a game
move_list = chess_variant.moves("123456")
print(f"Moves played: {move_list}")

# 5. Get the PGN for a game
print(chess_variant.pgn("123456"))

# 6. List all available variants
all_variants = chess_variant.variants()
print(f"Supported variants: {list(all_variants['variants'].keys())[:5]}...")