User Documentation • Version 1.0 (Core ML Native)

Speakeasy Documentation

Everything you need to install, configure, customize, and master sovereign on-device voice dictation on your Mac.

Quickstart Guides

Speakeasy is an air-gapped, on-device voice dictation and meeting transcription utility built natively in Swift and Rust for Apple Silicon (M1/M2/M3/M4). No cloud audio streaming, no monthly subscriptions.

Architecture & On-Device Processing

Unlike cloud-dependent dictation services (Wispr Flow, Aqua Voice, Typeless) that stream raw audio over WebSockets to remote servers, Speakeasy runs 100% locally on your Mac hardware.

system audio pipeline architecture
[Microphone / System Loopback] │ ▼ (16kHz PCM Stream) [CoreAudio Ring Buffer] │ ▼ (VAD - Voice Activity Detection) [Apple Silicon Neural Engine (Core ML)] ├── whisper-large-v3-turbo (quantized Core ML fp16) └── Custom Lexicon & Grammar Bias Matrix │ ▼ (Sub-450ms Cleaned Tokens) [Context-Aware Formatting Engine] ├── Dev Syntax Mode (camelCase, flags, terminal pipes) └── Prose Auto-Punctuation & Tone Filter │ ▼ (Accessibility API) [Active Window Target Cursor / Output Buffer]
🔒 100% Offline by Design

Speakeasy has no server backend for speech processing. You can disconnect your Wi-Fi, enable Airplane Mode, and experience zero degradation in transcription speed or accuracy.

Documentation Index

Guide Topic Target Audience
Getting Started DMG installation, Apple Silicon setup, Gatekeeper, permissions. All Users
Keyboard Shortcuts Trigger shortcuts, Push-to-Talk vs Push-to-Toggle, hands-free foot pedals. All Users
Bot-Free Meetings System audio capture, Zoom/Meet/Teams recording, speaker labeling, Markdown export. Founders, Managers, Remote Teams
Custom Dictionary Acronyms, custom vocabulary, Wispr Flow / Superwhisper 1-click JSON migration. SaaS Switchers, Specialists
Dev Syntax Hub camelCase, snake_case, CLI flags, terminal pipes, Claude Code & Cursor prompting. Developers & AI Coders
Troubleshooting & FAQ Accessibility permission resets, mic input gain, offline air-gap audit. All Users