Patzer

aigeneral

A private chess platform with Stockfish game reviews, household profiles, lessons, opening practice, local matches, and optional coaching through your own LLM

#chess#stockfish#game-review#ai-coach#ollama#vllm#family#docker#sqlite#self-hosted

Quick Start

docker run -d -p 8800:8800 -v patzer-data:/app/data --name patzer ghcr.io/SikamikanikoBG/patzer:latest

Overview

Patzer is a self hosted chess platform for households that want private game analysis, training, and local play. It can import public games from Chess.com and Lichess or accept pasted PGN files, then analyze each move with bundled Stockfish. Reviews include move classifications, accuracy scores, evaluation graphs, engine lines, opening detection, and explanations of tactical mistakes.

You can play against seven Stockfish levels or challenge another profile on the same server. Multiple users, household ratings, kid mode, interactive lessons, an opening trainer, and five interface languages are included. Everything runs in one Docker container with game data stored in a local SQLite database.

The optional AI coach connects to an Ollama or vLLM server on your network. Stockfish and chess.js calculate the position, candidate moves, and tactical facts before the language model writes an explanation. This keeps chess analysis grounded and means the main review features still work without an LLM.

Patzer assumes a trusted home network. It lacks rate limiting for analysis requests and a normal password reset workflow, so remote access should use a VPN or properly secured reverse proxy. Chess.com and Lichess imports, opening statistics, and update checks contact external services. Optional DeepSeek and hosted engine integrations send relevant data to those providers.

Patzer replaces much of the paid game review and private training workflow, but it does not provide Chess.com style public matchmaking, tournaments, social features, or video lessons. Its own code is MIT licensed, while bundled Stockfish and Chessground components use GPL licenses.

Use Cases

Specific ways to use Patzer for your workflow.

01
Import and review public Chess.com and Lichess games with Stockfish
02
Play against Stockfish or other household profiles on the same server
03
Practise openings and follow interactive chess lessons
04
Receive locally generated coaching explanations through Ollama or vLLM

Deployment Strategy

Recommended ways to host Patzer in your own environment.

docker
docker-compose
self-hosted