How conorod1992/speaker-recognition works
This repository delivers a two-part Home Assistant speaker-identification product: an integration that enrolls users and runs recognition alongside STT, and an HTTP app/add-on that trains and matches voice profiles. The main turn flow is supplemented by enrollment quality, calibration/review, live testing, diagnostics, and optional shadow-engine capabilities documented in the README. Edges cite the shown caller/import references or README; several integration and evaluation links remain unverified because their implementations were not excerpted.
Main entry points: api.py HTTP API · telemetry.py Decision history · stt.py STT coordination · enrollment.py Enrollment capture
Components 24
Home Assistant Integration
- HA integration setup
custom_components/speaker_recognition/config_flow.py - Enrollment capture
custom_components/speaker_recognition/enrollment.py - Sample quality
custom_components/speaker_recognition/enrollment_quality.py - STT coordination
custom_components/speaker_recognition/stt.py - Recognition request
custom_components/speaker_recognition/recognition.py - Turn correlation
custom_components/speaker_recognition/conversation.py
Recognition Service
- HTTP API
speaker_recognition/api.py - Embedding engines
speaker_recognition/engines.py - Profile matching
speaker_recognition/recognizer.py - Voice profiles
speaker_recognition/recognizer.py - Shadow recognition
speaker_recognition/shadow.py
Evaluation and Calibration
- Live satellite evaluation
custom_components/speaker_recognition/live_evaluation.py - Decision history
custom_components/speaker_recognition/telemetry.py - Threshold calibration
custom_components/speaker_recognition/calibration.py - Profile promotion
custom_components/speaker_recognition/promotions.py - Diagnostics
custom_components/speaker_recognition/diagnostics.py
Panels
- Enrollment panel
custom_components/speaker_recognition/www/speaker-recognition-panel.js - Calibration panel
custom_components/speaker_recognition/www/speaker-recognition-calibration-panel.js - Evaluation panel
custom_components/speaker_recognition/www/speaker-recognition-evaluation-panel.js - Settings panel
custom_components/speaker_recognition/www/speaker-recognition-settings-panel.js
Other components
- HA user
- Assist satellite
- STT provider
- Conversation agent
Connections 26
- HA user → Enrollment panel: enrolls speakers
- Assist satellite → Enrollment capture: provides samples
- Enrollment panel → Enrollment capture: stages recordings
- Enrollment capture → HTTP API: trains profiles
- Enrollment capture → Sample quality: assesses samples
custom_components/speaker_recognition/enrollment_quality.py - STT provider → STT coordination: transcribes audio
- STT coordination → Recognition request: runs concurrently
custom_components/speaker_recognition/stt.py - Recognition request → HTTP API: requests match
custom_components/speaker_recognition/recognition.py - HTTP API → Profile matching: dispatches inference
speaker_recognition/api.py - Profile matching → Embedding engines: creates embeddings
speaker_recognition/recognizer.py - Profile matching → Voice profiles: reads and updates
speaker_recognition/recognizer.py - HTTP API → Voice profiles: reports profiles
speaker_recognition/api.py - STT coordination → Turn correlation: correlates turn
- Turn correlation → Conversation agent: attaches identity
- Turn correlation → Decision history: records decision
- STT coordination → Decision history: records recognition
custom_components/speaker_recognition/telemetry.py - Live satellite evaluation → Assist satellite: observes Assist turn
- Calibration panel → Decision history: reviews decisions
custom_components/speaker_recognition/www/speaker-recognition-calibration-panel.js - Calibration panel → Threshold calibration: applies thresholds
- Calibration panel → Profile promotion: promotes samples
custom_components/speaker_recognition/www/speaker-recognition-calibration-panel.js - Decision history → Threshold calibration: supplies feedback
- Diagnostics → Decision history: reads decisions
custom_components/speaker_recognition/diagnostics.py - HTTP API → Shadow recognition: trains optionally
speaker_recognition/api.py - Evaluation panel → Live satellite evaluation: views test results
- Settings panel → HA integration setup: configures settings
- Enrollment panel → HA integration setup: configures service