Athena AI

Ein reproduzierbarer Docker-Stack für Athenas lokale KI. Ein Compose-Projekt enthält Router, llama.cpp-Profile, OpenWebUI, Hermes, Sprache, Bildgenerierung, fachliche MCP-Container und das regelmäßige Datenbackup.

Aufbau

• compose.yaml ist der einzige Einstieg; platform/mcp/compose.yaml wird mit Docker Composes standardisiertem include in dasselbe Projekt geladen.
• Genau ein llama.cpp-Profil ist aktiv. Der Router schaltet zwischen Fast, Medium, Large, Ultra und Uncensored.
• Der Athena Operator ist der einzige administrative MCP. Er liefert mit athena_operator_inspect(subject=guide) auch diese Plattformanleitung aus ATHENA.md.
• Home Assistant, ARR, Unraid, Navidrome, Deemix, GitHub und Web bleiben als getrennte Fach-MCPs isolierbar und unabhängig aktualisierbar.
• config/mcp-registry.json ist die einzige Liste der MCPs für Hermes und OpenWebUI. platform/mcp/sync-clients.py erzeugt beide Registrierungen.
• Modelle, Hermes-Daten und Backups liegen auf /data; Secrets ausschließlich unter /etc/mike-ai.
• KI-Oberflächen und APIs sind nur über WireGuard erreichbar.

Installation – ein Befehl

Nach dem Ausfüllen von config/install.env:

sudo ./install.sh --config config/install.env

Das Skript installiert Docker und NVIDIA-Unterstützung, lädt die konfigurierten Modelle, baut den Stack und startet die benötigten Profile und MCPs.

Bedienung

# Gesamten Stack anzeigen
docker compose --env-file /etc/mike-ai/stack.env ps

# Eine gezielte Änderung ausrollen
docker compose --env-file /etc/mike-ai/stack.env up -d --build mcp-arr

# Sofortiges Datenbackup zusätzlich zum Fünf-Stunden-Zeitplan
docker exec mike-ai-backup backup

OpenWebUI: http://<WireGuard-IP>:8080

Router-API: http://<WireGuard-IP>:8081/v1

Hermes: http://<WireGuard-IP>:9119

Wiederherstellung – ein Befehl

Nach einer frischen Installation und eingehängtem /data:

sudo ./restore.sh /data/docker-backups/athena-latest.tar.gz

Details, Prüfschritte und der exakte Sicherungsumfang stehen in docs/RECOVERY.md.

Dokumentation

• ATHENA.md – kurze Maschinen- und Operatoranleitung
• docs/STANDARD_PROFILE_MATRIX.md – Profile und Messwerte
• docs/RECOVERY.md – Backup und Neuaufbau

Git enthält keine Secrets, Chatdaten oder Modellgewichte.