72 lines
2.4 KiB
Markdown
72 lines
2.4 KiB
Markdown
# 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`:
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
# 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`:
|
||
|
||
```bash
|
||
sudo ./restore.sh /data/docker-backups/athena-latest.tar.gz
|
||
```
|
||
|
||
Details, Prüfschritte und der exakte Sicherungsumfang stehen in
|
||
[`docs/RECOVERY.md`](docs/RECOVERY.md).
|
||
|
||
## Dokumentation
|
||
|
||
- [`ATHENA.md`](ATHENA.md) – kurze Maschinen- und Operatoranleitung
|
||
- [`docs/STANDARD_PROFILE_MATRIX.md`](docs/STANDARD_PROFILE_MATRIX.md) – Profile und Messwerte
|
||
- [`docs/RECOVERY.md`](docs/RECOVERY.md) – Backup und Neuaufbau
|
||
|
||
Git enthält keine Secrets, Chatdaten oder Modellgewichte.
|