feat(stt): cadrage + squelette assistant vocal Jarvis

Conception validée du projet STT — assistant vocal/HUD du homelab Funk :
- HUD web sur-mesure + STT/TTS local (faster-whisper + Piper)
- Packaging commande pipx (stt), démarrage auto systemd --user
- Cerveau 3 modes + auto-détection LAN : hermes / local-direct / claude-direct
- Mémoire 3 tiers : SQLite local + Qdrant s01 + GitHub (distillée, versionnée)

Réutilise tools/hermes-voice, LiteLLM, Hermes Agent. Squelette + doc admin/ia/stt.md,
implémentation par phases (roadmap dans le doc).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT
This commit is contained in:
Claude 2026-06-17 09:04:53 +00:00
parent 22d40023e1
commit 8096ba208d
No known key found for this signature in database
10 changed files with 395 additions and 0 deletions

25
stt/config/README.md Normal file
View file

@ -0,0 +1,25 @@
# stt/config — personnalisation
Tout ce qui se change **sans recompiler**. `stt --setup` copie `stt.example.toml` vers
`~/.config/stt/stt.toml`.
```
config/
├── stt.example.toml # config de référence (modes cerveau, voix, thème, mémoire)
├── themes/ # thèmes HUD : couleurs, fond, style du visualiseur (CSS/JSON)
├── avatars/ # images / avatars affichés dans le HUD
└── voices/ # modèles Piper .onnx (TTS) — fr_FR par défaut
```
## Points de personnalisation
| Quoi | Où | Note |
|---|---|---|
| Image / avatar | `avatars/` + `ui.avatar` | swappable à chaud |
| Thème / design | `themes/` + `ui.theme` | couleurs, fond, visualiseur |
| Voix | `voices/*.onnx` + `voice.piper_voice` | géré par `stt --setup` |
| Wake word | `voice.wake_word` | défaut « Ok Hermès » |
| Cerveau | `[brain]` | mode + override + endpoints |
> 🔒 La clé Anthropic (mode `claude-direct`) passe par la variable d'env `ANTHROPIC_API_KEY`,
> **jamais** dans ce fichier (qui peut finir versionné).

View file

@ -0,0 +1,40 @@
# Configuration STT — copier vers ~/.config/stt/stt.toml (via `stt --setup`)
[brain]
# Mode cerveau : "auto" (détecte le LAN), "hermes", "local", "claude"
mode = "auto"
# Hôte testé pour décider LAN vs hors-LAN
lan_probe_host = "192.168.1.200"
[brain.hermes] # mode hermes (LAN) — agit sur Funk
url = "http://192.168.1.200:8080"
profile = "funk-ai"
[brain.local] # mode local-direct (LAN) — chat Qwen3 sur g01
url = "http://192.168.1.200:4000/v1/chat/completions"
api_key = "lm-studio"
model = "hermes-default"
[brain.claude] # mode claude-direct (hors-LAN) — chat seul
# Clé via variable d'env ANTHROPIC_API_KEY (ne JAMAIS committer la clé ici)
model = "claude-sonnet-4-6"
[voice]
wake_word = "hermes" # "Ok Hermès"
whisper_model = "large-v3" # STT (faster-whisper, CPU int8)
piper_voice = "fr_FR-upmc-medium" # TTS — voix dans config/voices/
language = "fr"
silence_sec = 1.2 # silence avant fin d'enregistrement
chat_timeout_sec = 60 # retour en veille sans interaction
[ui]
theme = "arc-reactor" # thème dans config/themes/
avatar = "default" # image dans config/avatars/
kiosk = true # ouvre le HUD en plein écran au lancement
[memory]
enabled = true
local_db = "~/.local/share/stt/memory.sqlite" # tier local (gitignoré)
distill_on_exit = true # distille → GitHub à l'arrêt
qdrant_url = "http://192.168.1.200:6333" # tier s01 (si LAN + Qdrant up)
qdrant_collection = "stt-memory"