# muff

Polish-first AI dictation for macOS. You dictate the way people actually speak — with the ums, the digressions, the swearing — and muff hands back finished text: an essay, a legal brief, a chapter. Everything runs on your Mac; audio and text never leave the device.

## Features

- **Hold to Dictate:** A configurable global shortcut records while you hold it. Release, and the cleaned-up text is pasted straight at your cursor in whatever app you were in.
- **Speech and Language, On-Device:** Speech recognition runs on the Apple Neural Engine and a bundled Polish-native language model cleans up the text. Nothing leaves the Mac — no cloud, no telemetry.
- **Writer Mode:** The Writer profile turns raw, rambling dictation into finished prose. Lawyer, teacher, student, email and notes profiles are on the roadmap.
- **Continuous Dictation:** Keep a session running hands-free instead of holding the key for every sentence — useful for long-form drafting.
- **Wake-Word Activation:** Start a dictation session from a spoken phrase rather than a keypress, with configurable stop phrases to end it.
- **Spoken Commands:** Say an emoji and it gets inserted; say a number in Polish or English and it lands as digits, not words.
- **Local History:** Every session is stored locally in SQLite with its audio segments, browsable from a History view on your own machine.
- **Live Overlay:** A floating pill with a waveform shows capture state, and a HUD shortcut cycles dictation modes without opening settings.

## Technology

SwiftUI, Swift, AppKit (menu-bar app), Parakeet ASR (CoreML / ANE), llama.cpp + Bielik, GRDB (SQLite), AVFoundation, Accessibility API, Astro (landing), Cloudflare Pages