How imutkarsht/chess_analyzer works
Chess Analyzer Pro is a local-first desktop chess analysis application. The main workflow starts in the desktop app, imports a game from PGN or an online account, analyzes positions with Stockfish, and presents move, tactical, and performance insights. The graph also preserves the documented opening-explorer, history, AI-coach, settings, and import capabilities. Relationships are limited to README statements and SOURCE INDEX references; several unsampled GUI and storage connections are therefore omitted rather than inferred.
Main entry points: analyzer.py Game analyzer · game.py Tactical analysis · engine.py Stockfish manager · main.py App startup
Components 31
Desktop app
- App startup
main.py - Main window
src/gui/main_window/window.py - First-run setup
src/gui/dialogs/setup_wizard.py - Engine settings
src/gui/views/settings/engine_settings.py - Interface styling
src/gui/styles.py - Theme palette
src/gui/theme/palette.py
Game import and history
- Game import UI
src/gui/dialogs/load_game/online_fetch_panel.py - PGN parser
src/backend/storage/pgn_parser.py - Chess APIs
src/backend/api/lichess_api.py - Game history
src/backend/storage/games_repo.py
Chess analysis
- Stockfish manager
src/backend/analysis/engine.py - Engine downloader
src/backend/engine/downloader.py - Game analyzer
src/backend/analysis/analyzer.py - Score utilities
src/backend/analysis/math_utils.py - Tactical analysis
src/backend/analysis/tactics/game.py - Board utilities
src/backend/analysis/tactics/board_utils.py - Hanging pieces
src/backend/analysis/tactics/hanging.py - Tactical motifs
src/backend/analysis/tactics/motifs.py - Exchange evaluation
src/backend/analysis/tactics/see.py
Insights and integrations
- Opening explorer
src/gui/views/explorer_view.py - Performance dashboard
src/backend/analysis/metrics_aggregator.py - Metric drill-down
src/gui/metrics/drill_down_view.py - AI coach
src/backend/services/groq_service.py - Coach worker
src/gui/analysis/coach_worker.py - Feedback service
src/backend/services/feedback_service.py
Local runtime support
- Analysis cache
src/backend/storage/cache.py - Game data models
src/backend/storage/models.py - User configuration
src/utils/config.py - Local paths
src/utils/path_utils.py - Application logging
src/utils/logger.py
Other components
- Chess player
Connections 37
- Chess player → App startup: starts
main.py - App startup → Main window: opens
main.py - App startup → Stockfish manager: resolves engine
main.py - App startup → First-run setup: opens when needed
main.py - Chess player → Game import UI: imports game
README.md - Game import UI → Chess APIs: fetches online games
README.md - Game import UI → PGN parser: loads PGN
README.md - PGN parser → Game data models: creates models
src/backend/storage/pgn_parser.py - Chess player → Game history: opens saved games
README.md - Game analyzer → Stockfish manager: uses engine
src/backend/analysis/analyzer.py - Game analyzer → Analysis cache: reads and writes
src/backend/analysis/analyzer.py - Game analyzer → Game data models: uses game data
src/backend/analysis/analyzer.py - Game analyzer → Score utilities: uses scoring
src/backend/analysis/analyzer.py - Game analyzer → Game history: uses history
src/backend/analysis/analyzer.py - Stockfish manager → Engine downloader: uses downloader
src/backend/analysis/engine.py - Tactical analysis → Score utilities: uses scoring
src/backend/analysis/tactics/game.py - Tactical analysis → Board utilities: uses board helpers
src/backend/analysis/tactics/game.py - Tactical analysis → Hanging pieces: uses hanging analysis
src/backend/analysis/tactics/game.py - Tactical analysis → Tactical motifs: detects motifs
src/backend/analysis/tactics/game.py - Hanging pieces → Board utilities: uses board helpers
src/backend/analysis/tactics/hanging.py - Hanging pieces → Exchange evaluation: uses exchange evaluation
src/backend/analysis/tactics/hanging.py - Tactical motifs → Board utilities: uses board helpers
src/backend/analysis/tactics/motifs.py - Tactical motifs → Exchange evaluation: uses exchange evaluation
src/backend/analysis/tactics/motifs.py - Chess player → Opening explorer: explores openings
README.md - Chess player → Performance dashboard: views performance
README.md - Chess player → Metric drill-down: explores metrics
README.md - Coach worker → AI coach: requests summaries
src/gui/analysis/coach_worker.py - Coach worker → Analysis cache: uses cache
src/gui/analysis/coach_worker.py - Coach worker → Tactical analysis: requests insights
src/gui/analysis/coach_worker.py - Chess player → Feedback service: submits feedback
README.md - First-run setup → User configuration: configures settings
- Engine settings → User configuration: reads settings
src/gui/views/settings/engine_settings.py - User configuration → Local paths: locates data
src/utils/config.py - Stockfish manager → User configuration: reads engine options
src/backend/analysis/engine.py - Interface styling → Theme palette: uses colors
src/gui/styles.py - Game analyzer → Application logging: logs activity
src/backend/analysis/analyzer.py - Stockfish manager → Application logging: logs activity
src/backend/analysis/engine.py