diff --git a/README.md b/README.md
index 489cb89..d74108a 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,26 @@ A fully-local, private voice assistant. Say **"Hey Jervis"** and make a request;
 controls your house, manages your shopping list, and speaks back through your speakers —
 driven by a single LLM "brain" that calls tools.
 
+## System map
+
+![Interactive map](https://maps.lab.audasmedia.com.au/homeassistant/docs/voice-assistant-map.html)
+
+```mermaid
+flowchart LR
+    ESP32[ESP32-S3<br/>wake word] -->|audio| WHISPER[Whisper STT]
+    WHISPER -->|text| AGENT[Jervis Agent<br/>:8501]
+    AGENT --> HA[Home Assistant<br/>control · todo · timers]
+    AGENT --> OMNI[OmniRoute<br/>LLM gateway]
+    AGENT --> MOPIDY[Mopidy / Spotify<br/>music]
+    AGENT --> APPRISE[Apprise<br/>notifications]
+    AGENT --> TTS[Piper TTS]
+    TTS --> SNAP[Snapcast<br/>multi-room]
+    SNAP --> SPK[House Speakers]
+    style AGENT fill:#bbf,stroke:#333,stroke-width:2px
+```
+
+> 🗺️ **Interactive version** (pan/zoom/search, dark/light, export): [voice-assistant-map.html](https://maps.lab.audasmedia.com.au/homeassistant/docs/voice-assistant-map.html) — hosted on `maps.lab.audasmedia.com.au`. Mermaid source: [`docs/voice-assistant.mmd`](docs/voice-assistant.mmd).
+
 ## Docs
 
 - **[`docs/overview.md`](docs/overview.md)** — the whole architecture in one page (diagram, hosts/IPs/ports, component map).
@@ -26,4 +46,4 @@ curl -X POST http://192.168.20.13:8501/voice \
 - `sam/speech_piper` — TTS → Snapcast
 - `sam/voice-assistant` — **this** overview + API + clients
 
-> Secrets live in `.env` (gitignored) — never commit them.
\ No newline at end of file
+> Secrets live in `.env` (gitignored) — never commit them.