Release v1.0.12 - Initial Release π
Speaker Recognition brings voice-based speaker identification to Home Assistant, allowing you to identify who is speaking using voice embeddings and the Resemblyzer library.
Features
- Speaker Recognition Integration: Custom Home Assistant integration that adds speaker recognition capabilities to your smart home
- RESTful API Service: Standalone API server for voice embedding generation and speaker identification
- Home Assistant Add-on: Easy-to-install add-on for running the speaker recognition service
- Speech-to-Text Support: Integration with Home Assistant's STT platform for seamless voice processing
- PyPI Package: Available as
hass-speaker-recognitionfor easy installation and integration
What's Included
- Custom Component (
speaker_recognition): Home Assistant integration with config flow support - Add-on: Dockerized service for local speaker recognition processing
- Python Package: Installable via
pip install hass-speaker-recognition - API Client: Python client library for interacting with the speaker recognition service
Installation
Home Assistant Add-on
- Add the repository to your Home Assistant add-on store
- Install the "Speaker Recognition" add-on
- Start the add-on
- Add the Speaker Recognition integration via the UI
Python Package
pip install hass-speaker-recognitionRequirements
- Home Assistant 2023.8 or later
- Python 3.9+ (for development)
- Architecture: amd64/x86_64 only (ARM/aarch64 not currently supported due to dependency constraints)
Known Limitations
- Platform Support: Currently only supports amd64 architecture
- Python Version: Server features require Python < 3.10 due to Resemblyzer compatibility
- LLVM Requirement: Requires LLVM 14+ for building dependencies
Configuration
The add-on exposes the following configuration options:
host: API server host (default: "0.0.0.0")port: API server port (default: 8099)log_level: Logging level (info, debug, warning, error, critical)access_log: Enable/disable access loggingembeddings_dir: Directory for storing speaker embeddings
API Endpoints
POST /train- Generate voice embedding from audioPOST /recognize- Identify speaker from audioGET /health- Health check endpoint
Full Changelog: https://github.com/eulemitkeule/speaker-recognition/commits/v1.0.0