wersperr/README.md
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

35 lines
940 B
Markdown

# 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
```sh
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
```sh
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.