How lutzwolfer/chess.com-bot works
The documented product is a desktop chess.com assistant: the user detects a visible board, starts a game, and receives Stockfish move suggestions or can enable automatic mouse moves. The primary runtime is python -m bot; the README also describes board detection, opponent-move observation, and optional move execution. The sampled manager excerpt establishes the main orchestration and UI behavior. Some internal calls are supported by the SOURCE INDEX reference list rather than shown call sites; unsampled subsystems and integrations are not expanded beyond documented behavior.
Main entry points: Manager.py Game manager · MouseControl.py Mouse control · StockfishManager.py Move analysis · ImageDetection.py Board vision
Components 14
Desktop interface
- Desktop GUI
bot/Manager.py - Main window UI
gui/main.ui
Game coordination
- Module entry
bot/__main__.py - Game manager
bot/Manager.py - Mouse control
bot/MouseControl.py
Board perception
- Board vision
bot/ImageDetection.py
Chess reasoning
- Chess position
bot/ChessBoard.py - Move analysis
bot/StockfishManager.py
Runtime support
- Engine configuration
bot/config.py - Logging
bot/logger.py
Other components
- Player
- Chess.com board
- Stockfish engine
- Mouse input
Connections 15
- Player → Desktop GUI: starts bot
README.md - Module entry → Game manager: launches UI
bot/__main__.py - Desktop GUI → Main window UI: loads layout
bot/Manager.py - Desktop GUI → Game manager: starts worker
bot/Manager.py - Game manager → Board vision: detects board
bot/Manager.py - Game manager → Board vision: observes moves
bot/Manager.py - Game manager → Chess position: updates position
bot/Manager.py - Game manager → Move analysis: requests best move
bot/Manager.py - Game manager → Mouse control: executes move
bot/Manager.py - Game manager → Chess.com board: captures screen
bot/Manager.py - Mouse control → Chess.com board: clicks squares
- Move analysis → Stockfish engine: analyzes position
bot/StockfishManager.py - Game manager → Engine configuration: loads settings
bot/Manager.py - Game manager → Logging: records events
bot/Manager.py - Player → Chess.com board: plays game
README.md