Patzer
Patzer

Your private Chess.com.

Self-hosted, AI-coached, family-friendly.
Stockfish + your own LLM (Ollama or vLLM), in one Docker container. Your games never leave home.

release GHCR As seen on Open Source Alternatives license CI stars

One command, five minutes, no cloud, no telemetry, no upsell.

Patzer Game Review — classified move list, engine lines and the What's-the-threat probe on a sacrifice from the Opera Game
Game Review — every move classified, top engine lines, and What's the threat? answering in plain words. Demo accounts, Morphy's Opera Game.

Why Patzer

A tiny, self-hosted take on the Chess.com / Lichess workflow you actually use.

Game Review

Pull your public Chess.com or Lichess games (or paste a PGN), analyze with bundled Stockfish, and get chess.com-style classifications, accuracy, estimated Elo, eval graph, key moments, top engine lines and a "What's the threat?" probe.

AI Coach — your LLM

Point at any Ollama or vLLM host. A coach, not a commentator: it explains why a move works or fails, shows the better move, and connects the mistake to your own recent games. It never contradicts the engine.

Play vs Bot & Friend

Seven Stockfish tiers (Kid → max), all time controls, up to six premoves, kid-mode blunder warnings — plus real-time PvP between profiles on the same server with draw offers, takebacks and one-click rematch.

Family-ready

Multi-user with admin console, per-profile language, kid-mode blunder warnings and "horsey" piece names for the youngest profiles. Open, invite-only or closed sign-up.

Learn & openers

69 interactive lessons in four levels, plus an opening trainer: drill 16 built-in main lines or your own repertoire; the moves you miss come back in a daily review queue.

Your games stay home

One Docker container on a Pi, NAS or old laptop. No cloud, no telemetry, no upsell. It even checks GitHub every six hours and tells you when a newer release is out.

The coach teaches from facts it is handed and never analyses on its own — Stockfish, chess.js and your own game history work out the facts server-side, so a small local model can't hallucinate moves or pieces.
Players directory — rating leaderboard, live presence and missed invitations
Players — everyone on your server, sorted by rating, with live presence and missed invitations. Dark mode is built in, per profile.

Compared to alternatives

The only self-hosted option with a bring-your-own-LLM coach.

PatzerLichess StudioChess.com ReviewAimchess
Self-hosted✅❌❌❌
LLM coach (BYO model)✅❌❌❌
Imports Chess.com✅❌✅✅
Imports Lichess✅✅❌✅
Multi-user / family✅❌❌❌
Multilingual coach✅partial UI❌❌
Free✅✅💳💳

First run in five minutes

Pick one. The Docker options open localhost:8800; the first visit walks you through a setup wizard.

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

docker compose

Prefer compose? The docker-compose.yml in the repo is the whole deployment — add the Watchtower label and your box tracks releases by itself.

Try it in your browser

Open in GitHub Codespaces spins up a temporary environment with Patzer + Stockfish pre-installed — the full app, no install, in about a minute.

The AI Coach needs an Ollama or vLLM host on your network (or the hosted DeepSeek API); Game Review on your own games needs a Chess.com or Lichess username. Everything else works out of the box.