Add overview, agent-api, clients docs for Jervis voice agent

README.md

@@ -0,0 +1,29 @@
+# voice-assistant — Jervis Voice Assistant
+
+A fully-local, private voice assistant. Say **"Hey Jervis"** and make a request; it answers,
+controls your house, manages your shopping list, and speaks back through your speakers —
+driven by a single LLM "brain" that calls tools.
+
+## Docs
+
+- **[`docs/overview.md`](docs/overview.md)** — the whole architecture in one page (diagram, hosts/IPs/ports, component map).
+- **[`docs/agent-api.md`](docs/agent-api.md)** — the command contract: send text, get a spoken reply. Use from any AI model, script, N8N, ESP32, or web app.
+- **[`docs/clients.md`](docs/clients.md)** — type-it, web page, and Android gateways.
+
+## Quick use
+
+```bash
+# speak a command (reply is spoken through speakers too)
+curl -X POST http://192.168.20.13:8501/voice \
+  -H "Content-Type: application/json" \
+  -d '{"text":"add chicken to the shopping list"}'
+```
+
+## Related repos
+
+- `sam/voice_assistant` — ESP32 firmware (wake word, mic)
+- `sam/voice_bridge` — STT bridge + whisper
+- `sam/speech_piper` — TTS → Snapcast
+- `sam/voice-assistant` — **this** overview + API + clients
+
+> Secrets live in `.env` (gitignored) — never commit them.