Go to file
type-two 1419baef20 polish: audio cues, Esc cancel, clipboard restore, silence gate, fixed language
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 17:43:07 +10:00
README.md polish: audio cues, Esc cancel, clipboard restore, silence gate, fixed language 2026-07-17 17:43:07 +10:00
wersper.py polish: audio cues, Esc cancel, clipboard restore, silence gate, fixed language 2026-07-17 17:43:07 +10:00

wersper

Private, self-owned Wispr Flow. Hold Right ⌥, speak, release — the transcription is pasted at your cursor. Everything runs locally on your Mac (Whisper large-v3-turbo via MLX on the GPU). No cloud, no accounts, no telemetry.

Run

uv run wersper.py

First run downloads the model (~1.6GB from Hugging Face) and installs deps.

macOS permissions (one-time)

Grant your terminal app both of these in System Settings → Privacy & Security:

  • Microphone — to record you
  • Accessibility — to paste into other apps (simulated ⌘V)

Self-check

uv run wersper.py --check

Notes

  • Esc while recording cancels the take.
  • Pop = recording started, Tink = text pasted.
  • Your clipboard is restored after pasting (text only — images are lost).
  • Hotkey, model, language, and silence threshold are constants at the top of wersper.py. Set LANGUAGE = None for autodetect.