Configure Hermes for German voice and responses

docs/CURRENT_REFERENCE.md

@@ -86,6 +86,13 @@ Der Router übernimmt:
 ## Hermes Agent
 
 - Container: `mike-ai-hermes`
+- Standardsprache: Deutsch (`display.language`, deutsches `SOUL.md`)
+- Spracheingabe: lokales Faster-Whisper, Modell `base`, Sprachhinweis `de`
+- Sprachausgabe: Athena-TTS über die OpenAI-kompatible Router-API; XTTS v2
+  mit **Annmarie Nele**, Piper als automatischer Fallback
+- Bei einer entfernten Hermes-Desktop-App läuft Audio bewusst über das
+  Hermes-Backend (`voice.client_direct: false`), weil Router und TTS nur im
+  internen Docker-Netz erreichbar sind.
 - Version: 0.20.5, offizielles Image per OCI-Digest gepinnt
 - Standardmodell: `qwen-medium`, 160.000 Kontext, über den Profile Router
 - Dashboard: WireGuard-Port 9119 mit Basic-Auth

platform/hermes/SOUL.md

@@ -0,0 +1,3 @@
+You are Hermes Agent, an intelligent AI assistant created by Nous Research. You are helpful, knowledgeable, and direct. You assist users with a wide range of tasks including answering questions, writing and editing code, analyzing information, creative work, and executing actions via your tools. You communicate clearly, admit uncertainty when appropriate, and prioritize being genuinely useful over being verbose unless otherwise directed below. Be targeted and efficient in your exploration and investigations.
+
+German is the user's default language. Reply in natural German unless the user asks for another language or the task requires preserving source-language content. Technical commands, identifiers, code, paths, product names, and quoted source text may remain in their original language.

platform/hermes/config.yaml

@@ -30,6 +30,37 @@ agent:
   gateway_timeout: 3600
   session_stall_timeout: 600
 
+# German is the platform default. The display setting localizes the static
+# messages Hermes currently supports; agent replies are governed by SOUL.md.
+display:
+  language: "de"
+
+# Speech input stays local and private. A fixed German hint avoids Whisper
+# interpreting short utterances as English while retaining the fast base model.
+stt:
+  enabled: true
+  provider: "local"
+  language: "de"
+  prompt: "Hermes, Athena, Qwen, OpenWebUI, Unraid, Home Assistant, Sonarr, Radarr, Navidrome"
+  local:
+    model: "base"
+    language: "de"
+
+# Reuse Athena's OpenAI-compatible TTS route. It currently serves XTTS v2 with
+# Annmarie Nele and transparently falls back to Piper when XTTS is unavailable.
+tts:
+  provider: "openai"
+  speed: 1.0
+  openai:
+    model: "piper"
+    voice: "alloy"
+    speed: 1.0
+    base_url: "http://router:8081/v1"
+
+voice:
+  auto_tts: true
+  client_direct: false
+
 skills:
   creation_nudge_interval: 20
 

platform/hermes/install-hermes.sh

@@ -11,6 +11,7 @@ die() { printf 'FEHLER: %s\n' "$*" >&2; exit 1; }
 [[ $EUID -eq 0 ]] || die "Bitte als root ausführen."
 [[ -s $SECRETS_DIR/router-api-key ]] || die "Router-API-Key fehlt."
 [[ -s $STACK_DIR/platform/hermes/config.yaml ]] || die "Hermes-Konfiguration fehlt im Stack."
+[[ -s $STACK_DIR/platform/hermes/SOUL.md ]] || die "Hermes-Systemanweisung fehlt im Stack."
 
 install -d -m 0700 "$HERMES_DATA_DIR"
 install -d -m 0750 "$HERMES_DATA_DIR/workspace"
@@ -32,6 +33,7 @@ fi
 
 cat >"$HERMES_DATA_DIR/.env" <<EOF
 ROUTER_API_KEY=$router_key
+VOICE_TOOLS_OPENAI_KEY=$router_key
 MUA_MCP_URL=$mua_url
 MUA_MCP_BEARER_TOKEN=$mua_token
 SEARXNG_URL=http://searxng:8080
@@ -55,5 +57,6 @@ if [[ -s $HERMES_DATA_DIR/config.yaml ]] && \
     "$HERMES_DATA_DIR/config.yaml.before-managed-update-$(date +%Y%m%d-%H%M%S)"
 fi
 install -m 0600 "$STACK_DIR/platform/hermes/config.yaml" "$HERMES_DATA_DIR/config.yaml"
+install -m 0600 "$STACK_DIR/platform/hermes/SOUL.md" "$HERMES_DATA_DIR/SOUL.md"
 chown -R 10000:10000 "$HERMES_DATA_DIR"
 printf 'HERMES_CONFIG_OK %s\n' "$HERMES_DATA_DIR"