Under the hood

How Vocaldi works

From shortcut to finished text or natural audio, the speech work happens on your Mac. Here is what runs locally, what uses the network, and why macOS asks for access.

Core processingOn your Mac

Dictation, cleanup, and Read Aloud run locally on Apple Silicon.

Network accessLimited

Used for setup downloads, licensing, updates, and optional diagnostics.

Mac accessTwo permissions

Microphone for dictation and Accessibility for shortcuts and insertion.

HOW IT WORKS

Your words stay on your Mac.

Vocaldi downloads its speech models once, then dictation, cleanup, and Read Aloud run locally on Apple Silicon. Core tools keep working offline.

Your Mac
DictationSPEECH → TEXT
Parakeet transcribes your microphone audio on your Mac, then Vocaldi inserts the result into the focused field.
CleanupTEXT → TEXT
Cleanup removes fillers and false starts locally. The transcript is not sent to a hosted language model.
Read AloudTEXT → SPEECH
Kokoro turns selected or copied text into audio on your Mac, using the voice and speed you choose.

Two models, both on your Mac

Both models run through Apple’s MLX framework. Network access is used for the initial model download, licensing, updates, and optional diagnostics, not speech processing.

SPEECH → TEXT

Parakeet TDT 0.6B v3

NVIDIA’s speech-recognition model, 4-bit quantized to about 607 MB. It provides punctuation and capitalization across 25 languages.

ARCHITECTUREFastConformer · TDT
ON DISK~607 MB · 4-bit
RUNTIMEMLX · Apple GPU
LICENSECC-BY-4.0
TEXT → SPEECH

Kokoro 82M

An open-weight text-to-speech model with 82 million parameters. It renders all 54 voices locally, without a cloud voice API.

ARCHITECTUREStyleTTS 2 · ISTFTNet
PARAMETERS82M · 24 kHz
RUNTIMEMLX · Apple GPU
LICENSEApache-2.0

Two permissions, each with one clear job

macOS asks before either permission is granted. You can review or revoke both in System Settings.

Microphone

Used only while you dictate. Vocaldi records the active session, transcribes it locally, then discards the temporary recording.

Accessibility

Lets Vocaldi listen for global shortcuts and insert your finished transcript into the field you already focused.