Files

T

duffyduckandClaude Opus 4.8 a0429fc91e feat(ai-box): Bootstrap fuer die KI-Box (Debian Trixie)

Idempotentes Setup einer frischen Trixie-Box zum GPU-Satelliten-Host: non-free (deb822-Format), NVIDIA-Treiber, Docker+Compose, nvidia-container-toolkit, GPU-im-Container-Test, xtts/.env, optional Stack-Start (--up).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-08-15 01:21:43 +02:00

2.3 KiB

Raw Blame History

ai-box — KI-Box (gpubox) Bootstrap

Macht aus einem frisch installierten Debian Trixie (headless, nur SSH) einen startklaren GPU-Satelliten-Host für den xtts-Stack (STT/TTS/LLM).

Was das Script tut

Basis-Pakete (curl, gnupg, git …)
contrib non-free non-free-firmware aktivieren (Trixie-deb822-Format berücksichtigt)
NVIDIA-Treiber installieren (nvidia-driver + firmware)
Docker Engine + Compose-Plugin
NVIDIA Container Toolkit + Docker-Runtime auf NVIDIA konfigurieren
xtts/.env aus .env.example anlegen (RVS_TOKEN optional gleich setzen)
GPU-im-Container-Test (docker run --gpus all … nvidia-smi)
optional (--up): den xtts-Stack hochziehen

Alles idempotent — mehrfach ausführbar.

Ablauf

git clone <repo> ARIA-AGENT
cd ARIA-AGENT/ai-box

sudo ./bootstrap.sh
# → Wenn der Treiber frisch installiert wurde: einmal neu starten, dann nochmal:
sudo reboot
# … nach dem Boot:
cd ARIA-AGENT/ai-box
sudo ./bootstrap.sh --up --token <DEIN_RVS_TOKEN>

Der Treiber-Reboot ist normal (Kernel-Modul wird erst beim Boot geladen). Beim zweiten Lauf überspringt das Script alles Erledigte und macht nur noch den GPU-Test + Stack-Start.

Optionen

Option	Wirkung
`--up`	am Ende `docker compose up -d --build` (Default-Profil)
`--token <TOK>`	`RVS_TOKEN` in `xtts/.env` eintragen (auch via `RVS_TOKEN=…` env)
`--rvs-host <H>`	`RVS_HOST` setzen

Wichtig

Stimm-Daten von der alten Gamebox kopieren (nicht in git): xtts/voice-id/ (Speaker-Fingerprint) und xtts/voices/ (F5-Referenz) nach xtts/ legen.
Voxtral bleibt aus auf der 3060 (braucht ≥16 GB VRAM). Das Default-Profil fährt Whisper (mit dem M0.1-Fix) + F5-TTS + lokales LLM. Voxtral erst mit der 24-GB-Karte: docker compose stop whisper-bridge && docker compose --profile voxtral up -d --build.
Erster Start lädt Modelle (mehrere GB via HuggingFace nach xtts/hf-cache
- xtts/models) — genug Platz (1 TB NVMe ✓) und etwas Geduld.

Verifizieren

nvidia-smi                                   # Host sieht die GPU
docker run --rm --gpus all nvidia/cuda:12.4.0-base-ubuntu22.04 nvidia-smi   # Container auch
docker logs -f aria-whisper-bridge           # "RVS verbunden" + service_status ready

2.3 KiB Raw Blame History