readme: add mermaid system map + link to interactive map on maps.lab
This commit is contained in:
20
README.md
20
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
|
||||
|
||||

|
||||
|
||||
```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).
|
||||
|
||||
Reference in New Issue
Block a user