Getting Started

Get the latest version of Chess Analyzer Pro directly from our releases page or build it from source.

Option A: Windows Executable (Recommended)

The easiest way to get started is using the standalone executable.

1. Download: Visit the Releases Page and download the latest ChessAnalyzerPro.exe.
2. Run: Double-click the file to launch the application.

[!NOTE] On first run, you may see a Windows SmartScreen warning. Click "More Info" → "Run Anyway" to proceed. This is normal for unsigned applications.

3. Configure Stockfish:
   • Download Stockfish from stockfishchess.org.
   • Extract it to a memorable location.
   • In the app, go to Settings > Chess Engine and select the stockfish.exe file.

Option B: Build from Source

For macOS/Linux users or developers who want the latest changes.

Prerequisites

• Python 3.10 or higher (Download)
• Git (Download)
• Stockfish (Download)

Windows Setup

# 1. Clone the repository
git clone https://github.com/imutkarsht/Chess_analyzer.git
cd Chess_analyzer

# 2. Create virtual environment
python -m venv venv

# 3. Activate virtual environment
.\venv\Scripts\activate

# 4. Install dependencies
pip install -r requirements.txt

# 5. Run the application
python main.py

macOS / Linux Setup

# 1. Clone the repository
git clone https://github.com/imutkarsht/Chess_analyzer.git
cd Chess_analyzer

# 2. Create virtual environment
python3 -m venv venv

# 3. Activate virtual environment
source venv/bin/activate

# 4. Install dependencies
pip3 install -r requirements.txt

# 5. Run the application
python3 main.py

[!NOTE] Since the app is built with PyQt6, it works best on KDE-based Linux distributions. On GNOME, some graphical glitches may occur, but the app remains fully functional.

Alternative: Using uv (Faster Package Management)

uv is a faster alternative to pip for managing Python packages.

# Install uv
pip install uv

# Create virtual environment
uv venv .venv

# Activate (Windows)
.venv\Scripts\activate

# Activate (macOS/Linux)
source .venv/bin/activate

# Install dependencies
uv pip install -r requirements.txt

# Run
python main.py

First Run Configuration

When you first launch Chess Analyzer Pro, follow these steps:

1. Configure Stockfish Engine (Required)

1. Click the Settings icon (gear) in the sidebar.
2. Under Chess Engine, click Browse.
3. Navigate to and select your Stockfish executable:
   • Windows: stockfish.exe
   • macOS/Linux: stockfish (no extension)
4. Click Save Engine Path.

2. Add API Keys (Optional)

For AI features and Lichess integration:

Gemini API Key (for AI Game Summary):

1. Get a free key at Google AI Studio.
2. Paste it in Settings > API Configuration > Gemini API Key.
3. Click Save.

Lichess Token (for private games/better rate limits):

1. Generate a token at lichess.org/account/oauth/token.
2. Select "Read games" scope.
3. Paste in Settings > API Configuration > Lichess API Token.

3. Set Your Usernames (Optional)

For personalized statistics and quick game loading:

1. Go to Settings > Player Usernames.
2. Enter your Chess.com and/or Lichess usernames.
3. Click Save.

Load Your First Game

From Chess.com

1. Click Load Game in the sidebar.
2. Select From Chess.com User....
3. Enter your username (or it auto-fills if configured).
4. Pick a game from the list.
5. Click Analyze Game to start analysis!

From PGN File

1. Click Load Game > Open PGN File....
2. Select your .pgn file.
3. The game loads automatically.
4. Click Analyze Game to start!

Verify Everything Works

After analysis completes, you should see:

• ✅ Move List with classification icons (green checkmarks, yellow/red markers)
• ✅ Evaluation Graph showing the game's momentum
• ✅ Stats Panel with accuracy percentage and move breakdown
• ✅ Board with arrows showing engine recommendations

If any of these are missing, check the Troubleshooting guide.

Next Steps

• 📖 Read the Usage Guide to master all features
• ⚙️ Explore Configuration for customization options
• 📊 Learn about How We Calculate Analysis
• 🏗️ Check Architecture to understand the codebase