Über ChessFEN
ChessFEN ist ein kleines, selbst hostbares Werkzeug für Schachnotationen: Stellungen aus Brettbildern erkennen, PGN-Partien durchsuchen und vollständige FENs exportieren sowie jede Figurenstellung oder vollständige FEN als Brettbild rendern. Es läuft auf der CPU, wird als einzelnes Docker-Image ausgeliefert und bietet dieselben Funktionen als Web-Oberfläche und API.
Projekt mit Stern markieren
Wenn ChessFEN nützlich ist, hilft ein Stern auf GitHub anderen, es zu finden.
★ Auf GitHub mit Stern markieren
Selbst betreiben
Veröffentlichte Release-Images stehen auf GHCR (ghcr.io/sidnelyzhang/chessfen) und Docker Hub (<DOCKERHUB_USERNAME>/chessfen) bereit; das Erkennungsmodell ist eingebettet. Ist das GHCR-Paket privat, zuerst docker login ghcr.io ausführen. Starte eines mit Docker:
docker run -d --name chessfen -p 127.0.0.1:8000:8000 \
-e ADMIN_PASSWORD='replace-with-a-strong-password' \
-e SECRET_KEY='replace-with-a-long-random-secret' \
-v chessfen-data:/data \
ghcr.io/sidnelyzhang/chessfen:latest
Das Repository enthält außerdem eine docker-compose.yml für das veröffentlichte Image: .env.example nach .env kopieren, ADMIN_PASSWORD und SECRET_KEY setzen und dann docker compose up -d ausführen; mit docker-compose.build.yml wird aus dem Quellcode gebaut.
Öffne dann http://localhost:8000 und erstelle API-Schlüssel auf der Verwaltungsseite. Der Container spricht nur HTTP: Veröffentliche den Port nur für deinen Reverse-Proxy und setze FORWARDED_ALLOW_IPS auf dessen Adresse, damit die Ratenbegrenzung echte Client-IPs sieht; mit DATABASE_URL wechselst du vom SQLite-Volume zu PostgreSQL.
Danksagung
- Brett-Erkennung: 2d-chess-ocr von Andrew Spano (feinabgestimmter YOLO26m-Detektor).
- Figurenbilder: das CBurnett-Schachfigurenset, gerendert mit python-chess (CC-BY-SA 3.0).
- Lizenz: ChessFEN steht unter der GPL-3.0-or-later-Lizenz.