From ddd77c7ad40405fedbdb426e32daf03ead13333f Mon Sep 17 00:00:00 2001 From: duffyduck Date: Wed, 30 Sep 2026 22:40:14 +0200 Subject: [PATCH] docs(xtts): openhands-Profil in .env.example und README sichtbar machen MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Das Profil existierte bereits in der compose-Datei, tauchte aber nicht in der Profil-Liste der .env.example auf — man konnte also nicht sehen, dass es waehlbar (und per Default AUS) ist. Jetzt dort gelistet, mit dem Hinweis, dass ohne Eintrag gar kein Container angelegt wird, plus Warnung, dass Profile compose v2 brauchen (das alte docker-compose 1.x behandelt sie unzuverlaessig). Co-Authored-By: Claude Opus 4.8 --- xtts/.env.example | 8 +++++++- xtts/README.md | 7 +++++-- 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/xtts/.env.example b/xtts/.env.example index ba50779..88bf32b 100644 --- a/xtts/.env.example +++ b/xtts/.env.example @@ -4,7 +4,7 @@ # ════════════════════════════════════════════════ # ─── Welche Dienste startet DIESER Node? ────────── -# Komma-getrennt aus: voxtral, whisper, f5tts, llm +# Komma-getrennt aus: voxtral, whisper, f5tts, llm, openhands # Nur die aufgefuehrten Dienste starten bei `docker compose up -d`. # nur STT-Box (Voxtral) → COMPOSE_PROFILES=voxtral # nur STT-Box (Whisper) → COMPOSE_PROFILES=whisper @@ -13,6 +13,12 @@ # Kleine Karte (wenig VRAM): Whisper + F5-TTS auf EINER GPU # → COMPOSE_PROFILES=whisper,f5tts # All-in-One, grosse Karte → COMPOSE_PROFILES=voxtral,f5tts,llm +# LLM + OpenHands-Oberflaeche → COMPOSE_PROFILES=llm,openhands +# 'openhands' ist REIN OPTIONAL (Standalone-Entwickler-Agent, s.u.). Wer es nicht +# auffuehrt, bei dem wird der Container gar nicht erst angelegt — das Image wird +# nicht einmal geladen. Fuer den normalen ARIA-Betrieb also einfach weglassen. +# ACHTUNG: Profile brauchen compose v2 (`docker compose`, mit Leerzeichen). Das +# alte `docker-compose` 1.x behandelt sie unzuverlaessig. # Hinweis: voxtral UND whisper zusammen NICHT sinnvoll — beide sind STT und # wuerden dieselbe Anfrage doppelt beantworten. Pro Node genau EINEN STT waehlen: # Voxtral-3B (~9 GB, beste Qualitaet) ODER Whisper (klein, passt neben F5-TTS). diff --git a/xtts/README.md b/xtts/README.md index 8bf4279..fa513f3 100644 --- a/xtts/README.md +++ b/xtts/README.md @@ -116,10 +116,13 @@ curl -s -H "Authorization: Bearer $LLM_OPENAI_KEY" \ ## OpenHands (optionales Profil) -Wer die Box **standalone** als Entwickler-Agent nutzen will, startet OpenHands gleich mit: +OpenHands ist **rein optional** und liegt in einem eigenen Profil. Wer es nicht in +`COMPOSE_PROFILES` aufführt, bei dem wird der Container **gar nicht erst angelegt** — +das Image wird nicht einmal geladen. Für den normalen ARIA-Betrieb also einfach weglassen: ```bash -COMPOSE_PROFILES=llm,openhands docker compose up -d +COMPOSE_PROFILES=voxtral,f5tts,llm docker compose up -d # ohne OpenHands +COMPOSE_PROFILES=llm,openhands docker compose up -d # mit OpenHands ``` Dann `http://:` (Default `3000`) öffnen. Das lokale Modell ist