Drop a chess screenshot in — or capture your screen live — and the bundled Stockfish 17.1 engine tells you the best move in under a second.
Drop in a PNG of any chess position. OpenCV finds the board, warps it to a grid, and recognises every piece.
Pick a region of your monitor with one drag. Arrows redraw automatically the moment the position changes.
Bundled NNUE engine, multi-core, 1 GB hash. Optional ELO cap from 1320 to 3190 for casual play.
Chess.com, Worldchess.com, Lichess and a default Merida set ship together. The detector picks the best match per square.
Undo / redo, jump to any earlier move, copy the whole game as PGN to your clipboard.
Everything runs locally. No network calls, no telemetry, no account.
Native arm64 build. May need xattr -dr com.apple.quarantine.
Always available at the latest release page.
git clone https://github.com/adnanahamed66772ndpc/ChessAI-Assistant cd ChessAI-Assistant python -m venv venv venv\Scripts\activate # or: source venv/bin/activate pip install pyside6 mss opencv-python python-chess flask numpy python desktop_app.py # native desktop app python main.py # Flask web UI on http://127.0.0.1:5000
Two extractors are included. Use the per-piece extractor when you want to grab close-up screenshots one piece at a time:
python extract_single_pieces.py "path\to\your_pieces_folder" my_theme
Filename parsing is spelling-tolerant — wight rook on black squear.png
works the same as white rook on dark square.png. The
detector automatically loads any new subfolder of piece_templates/.
Chess AI Assistant is intended for personal study, post-game analysis, position research, and chess-software development. Using it — or any external engine — to choose moves during a live game on platforms such as chess.com, lichess.org, worldchess.com, chess24, FIDE Online Arena, in rated tournaments, or in over-the-board play is cheating.
Such use violates the Terms of Service of every major chess site, the FIDE Anti-Cheating Regulations, and tournament rules worldwide. Consequences include account closure, forfeiture of titles or ratings, bans, disqualification, and potentially fines or legal action.
Acceptable uses ✅
Not acceptable ❌
You are solely responsible for how you use this software. By downloading, installing, or running it you agree that the author and contributors are not liable for any account termination, rating loss, tournament penalty, legal consequence, or other harm resulting from misuse.