Install Chess Analyzer Pro on Windows, macOS, or Linux, connect Stockfish, and launch the app for the first time.
Chess Analyzer Pro is a free, open-source desktop app for analyzing chess games with Stockfish. It runs on Windows, macOS, and Linux. Games, analysis, and settings stay on your machine. The optional AI Coach is the only feature that contacts another server, and the app works fully offline without it.

| Requirement | Details |
|---|---|
| Operating system | Windows 10 or newer, macOS 11 or newer, or a 64-bit Linux desktop |
| Chess engine | Stockfish. The app can download a matching build for you |
| Python | Only for building from source: Python 3.10 or newer |
| Internet | Only for downloads, Chess.com/Lichess imports, and AI Coach |
Download the latest installer from the Releases page.
ChessAnalyzerPro-2.6.0-Windows-Setup.exe.ChessAnalyzerPro-2.6.0-macOS.dmg.Download ChessAnalyzerPro-2.6.0-x86_64.AppImage.
Make it executable:
chmod +x ChessAnalyzerPro-2.6.0-x86_64.AppImage
Double-click the file, or run it from a terminal.
Use this path if you want to run the latest commit or work on the code.
git clone https://github.com/imutkarsht/Chess_analyzer.git cd Chess_analyzer python3 -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt python main.py
To use uv instead of pip:
uv venv .venv source .venv/bin/activate uv pip install -r requirements.txt python main.py
On the first run, the Setup Wizard opens over the landing page and walks through the whole configuration. Every step is optional and can be changed later in Settings.
The complete first-run setup: username, board theme, Stockfish download, AI Coach connection test, and the final summary
PATH, common install
locations, and any binary it downloaded previously. If nothing is found, the same screen offers a
one-click download for your platform.You can reopen these settings at any time from the sidebar gear.
| Check | What you should see |
|---|---|
| Engine | The status bar shows ● Engine ready |
| Wizard | It opens once, then stops appearing on later launches |
| Landing page | A historic game loads on the board with a welcome panel beside it |
| Navigation | Analyze, Explorer, History, Metrics, and Settings are in the sidebar |
If the status bar never reaches ● Engine ready, jump to
Troubleshooting.
Each page has a built-in tour. On first launch one starts automatically on the landing page; later
you can replay the tour for whatever page is open with Ctrl+T or the Start page tour entry in
the help menu.

The overlay highlights one element at a time and explains it, with Next, Back, and a step counter. Tours exist for the landing page, analysis workspace, Explorer, History, Metrics, the Metrics drill-down, and Settings.
Esc closes the tour early without marking it as seen, so it can start again next time.Ctrl+T always replays the tour for the current page.Load a game and run your first analysis in Your First Analysis.
Download Chess Analyzer Pro for Windows, macOS, or Linux. 100% free, private, and open-source.