wersperr/README.md
type-two bf70263d2a wersper: local push-to-talk dictation (MLX Whisper, one file)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 21:50:52 +10:00

32 lines
782 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
- Pasting overwrites your clipboard with the transcription.
- To change the hotkey or model, edit the constants at the top of `wersper.py`.