-
Notifications
You must be signed in to change notification settings - Fork 1
ADR 0003 Speech on Ada
Status: Accepted
Date: 2026-08-03
Milestone: M6 (voice path)

Phase 1 originally kept STT/TTS on the Pi (comstar-stt / comstar-tts) so the voice path did not depend on LAN bandwidth and PCM never left the box until a transcript reached AO. AO v1.28 and Reach v0.2 now advertise OpenAI-compatible speech sidecars on WebSocket hello.speech, discovered as SessionBridge.speechClient.
The Pi is already a thin I/O terminal for vision (frames → CPAI). Moving speech compute to the Ada host matches that split while capture, VAD, wake, playback, and the kiosk stay on the Pi.
-
Prefer Reach speech after
SessionBridge.startwhenspeechClient != null. -
Fall back to
COMSTAR_STT_URL/COMSTAR_TTS_URL(local Pi units or Mac bring-up) when speech is absent, disabled, or the session is not open. - Do not route utterance turns through AO MCP/planner solely for STT, and do not ferry PCM on the Reach session WebSocket.
- Optional
ReachConnectionConfig.speechTokenfromCOMSTAR_SPEECH_TOKEN/AGENTIC_SPEECH_TOKENwhen Ada sets a sidecar bearer. - Overlay /
direct_agentmust keep working withspeechClient == null.
- PCM for utterances leaves the Pi over LAN to Ada-advertised STT/TTS URLs — same trust boundary as CPAI and AO (LAN-only, Phase 1). Privacy docs reflect this deliberately.
- Production can stop requiring always-on
comstar-stt/comstar-ttsonce Ada speech is proven; keep those units for Mac/dev and offline fallback. - Re-bench live bridge fixtures (
mic → audio → bridge → remote STT) against the <15s / ideally <6s turn budget. - Requires AO ≥ 1.28 with
AGENTIC_SPEECH_ENABLED=1and advertised sidecar URLs.
COMSTAR AI — Not a mystical AI. A tool you engineered — transparent, hackable, fast.
Home · Architecture · Admin Console · Runbook · Contracts
Apache-2.0 · Pre-alpha · Raspberry Pi 4 terminal + local AI server
COMSTAR AI
Start here
Product
Build & configure
Interfaces
- Contracts Overview
- Bridge ↔ Kiosk
- Bridge ↔ Audio
- CodeProject.AI
- AO Reach
- MCP Tools
- Attention State Machine
Features
- Speech (STT/TTS)
- Vision & Face Enrollment
- Directory Identity
- Wake Word
- MCP Topology
- Terminal Control
- Google Workspace
Decisions (ADRs)
- ADR Index
- 0001 Audio Routing
- 0002 Render Path
- 0003 Speech on Ada
- 0004 Terminal Control
- 0005 LDAP Identity
- 0006 House Presence
- 0007 Full-Duplex AEC
- 0008 TTS Engine
- 0009 Proactivity
- 0010 Text Channel
- 0011 Road VPN
- 0012 Admin Network
- 0013 AO mTLS
- 0014 Fallback Hotspot
Operate
Plan
Meta