From 9701ab430a0d69ed361abe119f8715518849ac42 Mon Sep 17 00:00:00 2001
From: Sam Rolfe <samuelrolfe@gmail.com>
Date: Sun, 30 Aug 2026 14:54:08 +1000
Subject: [PATCH] sam-4screen-desktop 2026-8-30:14:54:8

---
 .obsidian/workspace.json                      |  4 +-
 .../Home Voice Assistant System.md            | 45 +++++++++++++++++++
 2 files changed, 47 insertions(+), 2 deletions(-)
 create mode 100644 300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md

diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json
index 07ac510..12fe780 100644
--- a/.obsidian/workspace.json
+++ b/.obsidian/workspace.json
@@ -210,8 +210,9 @@
       "templater-obsidian:Templater": false
     }
   },
-  "active": "b0724d9a8e78110f",
+  "active": "8018aa52f0591df9",
   "lastOpenFiles": [
+    "300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md",
     "300 areas/360 Dev-Ops Network Computers/Docker Containers.md",
     "300 areas/360 Dev-Ops Network Computers/Home Network Map Overview.md",
     "300 areas/360 Dev-Ops Network Computers/Filesystem Drive Map.md",
@@ -237,7 +238,6 @@
     "300 areas/360 Dev-Ops Network Computers/Backup System — Borg, Kopia & Restic.md",
     "300 areas/360 Dev-Ops Network Computers/Bumblebee - The Open-Source Scanner for Messy Dev Machines.md",
     "200 projects/220 Web Host Migration/Local Web Host.md",
-    "200 projects/220 Web Host Migration/AWS Cloud Emulator Floci.md",
     "000 daily/ThinkPad Recommendations",
     "500 archive/510 Daily",
     "300 areas/305 Ideas Businesses",
diff --git a/300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md b/300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md
new file mode 100644
index 0000000..14470a7
--- /dev/null
+++ b/300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md	
@@ -0,0 +1,45 @@
+---
+created: 2026-08-30
+modified: 2026-08-30
+type: note
+tags:
+  - voice
+  - system
+  - ai
+aliases:
+  - Jervis
+  - Voice Assistant
+---
+
+# Home Voice Assistant System (Jervis)
+
+> **Source of truth:** Gitea repo `sam/voice-assistant` → `https://gitea.lab.audasmedia.com.au/sam/voice-assistant`
+> Docs: `docs/overview.md`, `docs/agent-api.md`, `docs/clients.md` (in that repo).
+
+## TL;DR
+Local, private voice assistant. "Hey Jervis" → natural language → one LLM brain (voice-agent on `.13:8501`)
+decides intent → calls tools (time/weather/shopping/HA control/reminders/character voices) → speaks via piper → Snapcast.
+
+**Command it from anywhere:** `POST http://192.168.20.13:8501/voice {"text":"add milk to the shopping list"}` (reply is spoken).
+
+## Components (host:port)
+| Component | Host | Port | Role |
+|---|---|---|---|
+| ESP32-S3 (wake word) | — | — | mic, LED |
+| voice_bridge / voice_whisper | .13 | docker/:5000 | STT |
+| **voice-agent (LLM brain)** | .13 | **:8501** | tool-calling |
+| OmniRoute | .13 | :20129 | LLM gateway |
+| piper_tts | .13 | :10200 | TTS |
+| Snapcast | .13 | :1780 | audio |
+| Home Assistant | .30 | :8123 | control |
+| KitchenOwl | .35 | owl.lab | shopping |
+| mosquitto | .13/.30 | :1883 | MQTT |
+
+See the repo `docs/overview.md` for the full diagram + `docs/agent-api.md` for the API contract + `docs/clients.md` for type/web/Android.
+
+## Status (2026-08-30)
+- Voice-over-Snapcast restored (piper docker + HA→.13 SSH auth fixed).
+- Agent persistent as NixOS systemd service; tools verified: time, weather, shopping (KitchenOwl), HA control, reminders, feed-fish, character voices (Trump etc.).
+- Next: play_music (Mopidy), calendar (N8N), Apprise messaging (sam/jo/harry/finn), extended TTS voices.
+
+See also: [[Docker Containers]], [[Home Network Map Overview]].
\ No newline at end of file