How torom/botli works
Main Components
a) Core Components:
• Lichess API Interface
• UCI Engine Manager
• Game Manager
• Matchmaking System
• Challenge Handler
• Opening Book Manager
• Configuration Manager
b) External Services:
• Lichess API
• UCI Chess Engines
• Opening Books
• Endgame Tablebases (Syzygy/Gaviota)
Component Relationships
a) Primary Data Flow:
• Lichess API <-> API Handler (api.py)
• Engine Manager (engine.py) <-> UCI Engines
• Game Manager (game_manager.py) <-> Lichess Game Handler (lichess_game.py)
b) Secondary Flows:
• Configuration (config.py) -> All Components
• Event Handler (event_handler.py) -> Game Manager
• Challenger (challenger.py) -> Matchmaking (matchmaking.py)
Implementation Details
• user_interface.py: Entry point and command handling
• game_manager.py: Central game coordination
• engine.py: UCI engine communication
• challenger.py & matchmaking.py: Challenge management
• botli_dataclasses.py: Data structures
• config.py & configs.py: Configuration management
Deployment Aspects
Deployment options:
• Docker container
• Systemd service
• Interactive mode
• Non-interactive mode