WarbleInstallation
Build Warble from source and install it in ~/Applications.
Warble is distributed as source for now. Building takes one command.
Requirements
- macOS 26 or later.
- Xcode 26 or the matching Command Line Tools (Swift 6.2).
- About 500 MB of free space for the Parakeet model (
parakeet-tdt-0.6b-v3, int8), downloaded on first launch.
Install
Clone the repository
git clone https://github.com/pieralukasz/warble.git warble
cd warbleBuild and install
scripts/install.shThis builds a release binary, bundles Warble.app, copies it to ~/Applications and links the warble command into ~/.local/bin. Warble opens when it finishes.
Follow the setup window
The first launch opens setup, which asks for the Microphone and Accessibility permissions and downloads Parakeet. See Your first dictation.
Coming from open-wispr?
Warble copies ~/.config/open-wispr/config.json on first launch, so your hotkey, language and microphone carry over. Quit the old app before using Warble, because both listen to the same key.
For agents
A coding agent such as Claude Code or Codex can do the install for you. Paste this prompt into it:
Install Warble, the free local voice dictation app for macOS, from
https://github.com/pieralukasz/warble.
1. Check that this Mac runs macOS 26 or later (`sw_vers -productVersion`) and
that Swift 6.2 or later is available (`swift --version`). If not, stop and
tell me what is missing.
2. Clone the repository into ~/Projects/warble, or pull it if it is already
there, and run `scripts/install.sh` from its root.
3. Run `~/.local/bin/warble status` and show me the output.
4. Tell me that Warble opened a setup window, and that I have to allow the
Microphone and Accessibility permissions there myself.
The full documentation, as plain text for agents:
https://warble.lucaspiera.com/llms-full.txtOr run the same steps yourself:
git clone https://github.com/pieralukasz/warble.git ~/Projects/warble \
|| git -C ~/Projects/warble pull --ff-only
cd ~/Projects/warble && scripts/install.sh
~/.local/bin/warble statusThe install needs no input until the end, when macOS asks a person to allow the Microphone and Accessibility permissions. An agent cannot click those for you.
For agents that read documentation, the site publishes an index at /llms.txt, every page in one file at /llms-full.txt, and each page as Markdown through the Copy Markdown button at the top.
Start at login
Turn on Settings → System → Start Warble at login, or run warble enable-autostart.
Update
Pull the latest changes and run scripts/install.sh again. Your settings, history and dictionary are kept.
Uninstall
scripts/uninstall.sh # removes the app, keeps your data
scripts/uninstall.sh --purge # also deletes settings, history and dictionaryThe Parakeet model lives in ~/Library/Application Support/FluidAudio and is left in place, since other FluidAudio apps can share it.