sam-4screen-desktop 2026-10-16:18:21:28

300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md

@@ -1,6 +1,6 @@
 ---
 created: 2026-08-30
-modified: 2026-10-08
+modified: 2026-10-16
 type: area
 status: active
 tags:
@@ -17,7 +17,7 @@ aliases:
 
 > **Human-readable overview of the local voice-assistant project.**
 > - **AI/project tracking:** Vikunja → *Jervis Voice Assistant (Whisper ESP HA Flow)* (project id 5)
-> - **AI documentation (for bots):** Outline → *Voice Assistant (Whisper ESP HA)* collection → [Project Overview](/doc/project-overview-genev9IHFT)
+> - **AI documentation (for bots):** Outline → *MiniMax Voice (STT + TTS)* collection
 > - **API/docs (Gitea):** `sam/voice-assistant` → overview / agent-api / clients
 > - **Tasks/progress:** see the Vikunja project; docs live in Outline; this note is the human map.
 
@@ -40,6 +40,12 @@ local; only the spoken command is sent to the cloud.
   with piper fallback.
 - **Personality**: the agent emits a speech plan (inline sound tags + one
   emotion/delivery config). Kill switch: `VOICE_PERSONALITY=0`.
+- **Voice rotation**: Jervis draws each reply's voice from a **13-voice shuffle
+  bag** (`tts_router/speech_plan.py` → `MINIMAX_VOICES`); the voice is random and
+  decoupled from mood, one per cycle with no back-to-back repeat. Newest member
+  is **Aussie Sam**, an instant clone (`moss_audio_4b669dff-c927-11f1-9228-82eadf641028`)
+  added 2026-10-16. The bag is in process memory, so a `voice-agent` restart
+  loads it.
 - **Result**: about 239 MiB of resident RAM freed, better voices, and voice
   input survives an internet outage.
 - Full project note: [[MiniMax Voice — Cloud STT and TTS with Local Fallback]].
@@ -96,9 +102,9 @@ FastAPI · Python · Docker · MQTT · Home Assistant (REST/Assist/automations)
 
 ## Key configs & links
 - **Vikunja project**: `https://vikunja.lab.audasmedia.com.au` → *Jervis Voice Assistant (Whisper ESP HA Flow)*
-- **Outline collection**: `https://outline.lab.audasmedia.com.au` → *Voice Assistant (Whisper ESP HA)*
+- **Outline collection**: `https://outline.lab.audasmedia.com.au` → *MiniMax Voice (STT + TTS)*
 - **MiniMax Voice project**: `/home/sam/paseo/projects/minimax_voice_tts_stt/` on `.13`; map at `https://maps.lab.audasmedia.com.au/minimax_voice_tts_stt/docs/`
-- **Gitea**: `sam/voice-assistant` (overview / agent-api / clients docs)
+- **Gitea**: `sam/minimax_voice_tts_stt` (this project) and `sam/voice-assistant` (overview / agent-api / clients docs)
 - **Repo layout / plan**: `~/chats/homeassistant` (plan.md, AGENT.md); agent at `/home/sam/voice-agent/`
 - **Secrets**: `~/.config/environment.d/10-secrets.conf` on .27/.13/.51 (VIKUNJA_TOKEN, OL_API_KEY, etc.) — see also the `secrets_fixes` note.