whisper-stt-cli/CHANGELOG.md

Änderungsprotokoll

Alle nennenswerten Änderungen an whisper-stt-cli. Versionsnummer: stt_core.__version__ (erscheint in /health, in der FastAPI-Doku und im Wyoming-info).

0.2.0 — 2026-09-14

Neu

• CLI --until-enter: Aufnahme mit beliebig langen Pausen; Enter beendet, der gesamte Text wird als ein Ergebnis ausgegeben. Funktioniert mit dem Dienst und mit --local.
• Optionale LLM-Nachkorrektur (stt_llm.py, CLI --llm-correct, --llm-model, --llm-url): korrigiert offensichtliche Erkennungsfehler mit einem lokalen LLM (Standard gemma4:12b über Ollama, OpenAI-kompatible Server möglich). Strenger Prompt, Ähnlichkeitsprüfung und Fehler-Fallback auf den Rohtext; --json liefert raw_text und Korrekturdetails. Standardmäßig aus.
• Umgebungsvariablen STT_LLM_* für die LLM-Korrektur.
• Umfassende Dokumentation: BEDIENUNGSANLEITUNG.md, docs/API.md, docs/ENTWICKLER.md, dieses Änderungsprotokoll.
• Repository whisper-stt-cli auf kitux.de (Forgejo): https://kitux.de/forgejo/dschlueter/whisper-stt-cli

Geändert

• Ungültige Kombinationen von CLI-Optionen enden mit Exit-Code 1 (Fehler) statt 2.
• Die alten Einzelskripte stt.py und stt_respeaker.py liegen jetzt in legacy/.
• Projektname whisper-stt-cli (Gegenstück zu chatterbox-tts-cli); Wyoming meldet die neue Projekt-URL.

0.1.0 — 2026-09-13

Erste Version als Dienst — Neuentwurf des alten Einzelskripts stt.py.

• stt_core.py: Whisper-Engine (faster-whisper) mit einmaligem Laden, GPU→CPU-Fallback, Dekodierung beliebiger Audioformate, Halluzinationsfilter, Äußerungserkennung per Silero-VAD.
• stt_service.py: FastAPI-Dienst mit /health, /v1/audio/transcriptions (OpenAI-kompatibel), /transcribe (Rohdaten) und WS /ws/stream (Live-Streaming); Inferenz in einem Worker-Thread, begrenzte Warteschlange (HTTP 503).
• stt_wyoming.py: Wyoming-Protokoll für Home Assistant (TCP 10300).
• stt_cli.py: Dateien und Mikrofon über den Dienst oder lokal; Standardmikrofon über PipeWire, ReSpeaker XVF3800 automatisch mit ASR-Kanal.
• Tests (Unit und Integration), systemd-User-Unit deploy/stt-service.service.