Installation

Über Docker Compose mit dem Profile with-voiceid (oder full) dazuschalten. Braucht eine eigene voiceid-config.yaml, ist aber auch ohne sie mit brauchbaren Defaults lauffähig (siehe Konfiguration).

Native Installation

curl -fsSL https://github.com/NurPech/Hannah/raw/refs/heads/master/voiceid/deploy/install.sh | sudo bash

Config: /etc/hannah-voiceid/config.yaml. Die Vorlage liegt bereits im Release, im Installationsverzeichnis — kopieren, anpassen, Dienst starten:

sudo cp /opt/hannah/voiceid/config.example.yaml /etc/hannah-voiceid/config.yaml
sudo nano /etc/hannah-voiceid/config.yaml
sudo systemctl enable --now hannah-voiceid

Prüfen, ob der Dienst wirklich läuft:

sudo systemctl status hannah-voiceid
sudo journalctl -u hannah-voiceid -f

Zum Deinstallieren (Voice-Profile bleiben erhalten), Script liegt bereits im Installationsverzeichnis:

sudo bash /opt/hannah/voiceid/deploy/install.sh --uninstall

Unter macOS gibt es eine eigene Variante:

curl -fsSL https://github.com/NurPech/Hannah/raw/refs/heads/master/voiceid/deploy/install-macos.sh | sudo bash

Config dort: /opt/hannah/etc/voiceid.yaml — anderer Pfad und Dateiname als unter Linux. Das Script legt sie nicht automatisch an; ohne sie läuft VoiceID mit generischen Defaults (unknown_threshold=0.25, uncertain_threshold=0.40).

Prüfen, ob der Dienst wirklich läuft:

sudo launchctl print system/com.hannah.voiceid
sudo tail -f /opt/hannah/voiceid.log

Zum Deinstallieren, Script liegt ebenfalls schon im Installationsverzeichnis:

sudo bash /opt/hannah/voiceid/deploy/install-macos.sh --uninstall

Automatisch aktuell halten

Optional — nur relevant, wenn du AutoDeploy einsetzt. Vorher den Sicherheitshinweis zu post_install lesen. Eintrag mit macOS-Pfaden/Service-Namen:

macOS (/opt/hannah/etc/autodeploy.yaml)

  - name: voiceid
    channel: voiceid-stable
    install_dir: /opt/hannah/voiceid
    service: com.hannah.voiceid
    post_install: "/opt/hannah/voiceid/venv/bin/pip install -q -r /opt/hannah/voiceid/requirements.txt"

Unter Linux gilt dasselbe Format wie bei den anderen Komponenten (service als systemd-Name statt com.hannah.*, Config in /etc/hannah/autodeploy.yaml).