feat: add hallucination detection and watchdog for stuck transcriptions

2026-03-01 11:15:59 -05:00
parent 2999502434
commit 00231cc747
2 changed files with 111 additions and 3 deletions
@@ -34,6 +34,10 @@ Run the script using `python3 transcribe.py` with optional flags.
  ```bash
  python3 transcribe.py -l
  ```
+- **Caption system audio (speakers) using a loopback device:**
+  ```bash
+  python3 transcribe.py --loopback -es
+  ```
 - **Transcribe and translate to Spanish (screen only):**
  ```bash
  python3 transcribe.py -es
@@ -55,6 +59,7 @@ Run the script using `python3 transcribe.py` with optional flags.
 - `-i`, `--ingest`: Enable data transmission to the remote server.
 - `-l`, `--list-devices`: Show available audio devices and exit.
 - `-d`, `--device [ID]`: Input device index (bypasses selection prompt).
+- `--loopback`: Automatically select a loopback device (e.g., BlackHole, Stereo Mix) to caption system audio.
 - `-q`, `--quantize`: Use 4-bit quantized Whisper model for faster transcription (Strategy 3).
 - `-s`, `--stream`: Enable real-time streaming transcription/draft mode (Strategy 1).
 - `-c`, `--context`: Enable prompt caching/rolling context to help the model maintain sentence continuity across chunks.