Ü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