3.0 KiB
Athena AI
Athena ist die lokale Inferenzmaschine. Der reproduzierbare Docker-Stack stellt Qwen über eine kleine OpenAI-kompatible Router-API bereit und übernimmt lokale Bild- und Sprachausgabe. Hermes und die Fach-MCPs laufen auf Unraid.
Aktueller Aufbau
Athena
- genau ein aktives llama.cpp-Profil: Fast, Medium, Large, Ultra oder Uncensored
- Profile Router auf Port 8081
- Z-Image-Turbo als exklusiver Bild-Worker auf der RTX 5080
- XTTS auf der RTX 3060 mit Piper als CPU-Fallback
- Live-Dashboard mit 21 Tagen Detailhistorie auf Port 8099
- WireGuard-Gateway, Datenbackup und Athena-Operator
- keine produktive Hermes-, OpenWebUI- oder portable Fach-MCP-Instanz
Unraid
- offizieller Hermes-Agent mit persistentem Appdata
- je ein eigener Container für ARR, Deemix, Navidrome, STRATO und Nginx Proxy Manager
- MUA/Unraid-MCP als Unraid-Plugin
- Media-Tools als nachrüstbare Werkzeugkiste
- Sicherung durch das vorhandene Unraid-Appdata-Backup
Hermes nutzt Athenas Router unter http://192.168.1.212:8081/v1. Ein MCPHub
ist nicht mehr Bestandteil der produktiven Architektur.
Installation – ein Befehl
cp config/install.env.example /root/mike-ai-install.env
# Werte in /root/mike-ai-install.env eintragen und chmod 600 setzen
sudo ./install.sh --config /root/mike-ai-install.env
Das Installationsskript baut llama.cpp und die lokalen Images, lädt die versionierten Modellartefakte und startet ausschließlich den Athena-Kern.
Betrieb
# Konfiguration prüfen
./manage.sh validate
# Gesamten Athena-Kern gezielt aktualisieren
./manage.sh deploy core
# Nur einen Dienst ausrollen
./manage.sh deploy router
# Eindeutige Altcontainer entfernen
./manage.sh purge-legacy
# Read-only Ende-zu-Ende-Test
sudo ./smoke-test.sh
Endpunkte
- Router:
http://192.168.1.212:8081/v1 - Athena-Dashboard:
http://192.168.1.212:8099 - Hermes-Dashboard auf Unraid:
http://192.168.1.2:9119
Die Adressen sind nur über die vorgesehenen privaten Netze erreichbar.
Ausgegliederte MCPs
Weitere produktive Container verwenden ihre jeweiligen Upstream-Images und Unraid-DockerMan-Templates. Details stehen in docs/MCP_SERVERS.md.
Wiederherstellung
Nach einer frischen Debian-Installation und erneut eingehängtem /data:
sudo ./install.sh --config /root/mike-ai-install.env
sudo ./restore.sh /data/docker-backups/athena-latest.tar.gz
sudo ./smoke-test.sh
Der genaue Sicherungsumfang steht in docs/RECOVERY.md.
Verbindliche Dokumentation
- ATHENA.md – kurze Betriebsanleitung
- docs/STANDARD_PROFILE_MATRIX.md – Profile
- docs/MCP_SERVERS.md – produktive Werkzeuge
- docs/RECOVERY.md – Backup und Neuaufbau
Git enthält keine Secrets, Chatdaten oder Modellgewichte.