░█▀▄░█░░░█░█░█▀▄░▀█▀ ░█▀▄░█░░░█░█░█▀▄░░█░ ░▀▀░░▀▀▀░▀▀▀░▀░▀░░▀░
Talk to your coding agents.
On-device voice-to-text for macOS. Press right ⌘, speak, then press it again - your words go straight into Claude Code, Codex, Cursor, OpenCode or any other agent, wherever your cursor is.
Install
brew tap satyaborg/blurt
brew install blurt
Or via pipx:
pipx install blurt
Requires macOS with Apple Silicon.
First run downloads the selected transcription model once. macOS will prompt for Microphone and Accessibility access (System Settings → Privacy & Security).
Usage
| Action | Description |
|---|---|
| Press right ⌘ | Start recording |
| Press right ⌘ again | Stop, transcribe, paste at cursor |
| Ctrl + C | Quit |
Models
| Mode | Model | Use case |
|---|---|---|
fast |
Qwen3-ASR 0.6B 8-bit | Default, lowest latency |
accurate |
Qwen3-ASR 1.7B 8-bit | Higher accuracy |
blurt mode fast # use the default 0.6B model
blurt mode accurate # use the higher-accuracy 1.7B model
The fast mode downloads an approximately 1 GB MLX checkpoint, while accurate mode downloads an approximately 2.5 GB MLX checkpoint. Custom words and filename-shaped repository terms are passed to Qwen as transcription context.
Custom Words
Teach Blurt words it gets wrong (names, jargon, acronyms):
blurt add "Claude Code" # add a word
blurt vocab # list all
blurt rm "Claude Code" # remove
Words are stored in ~/.blurt/vocab.txt (one per line).
@-mentions
Run Blurt from a git repo and spoken filenames automatically resolve to @path/to/file references that coding agents understand. For example, saying "check init.py for the bug" becomes check @blurt/__init__.py for the bug.
Transcript History
blurt log # view recent transcripts
Logs are stored in ~/.blurt/log.txt.
Update
blurt upgrade
Troubleshooting
| Issue | Fix |
|---|---|
| "Microphone access" prompt doesn't appear | System Settings → Privacy & Security → Microphone → enable your terminal |
| "Accessibility" error | System Settings → Privacy & Security → Accessibility → enable your terminal |
| No audio / recording fails | brew install portaudio then restart your terminal |
| Model download stalls | Check available space in ~/.cache/huggingface/ for the selected model |
Contributing
git clone https://github.com/satyaborg/blurt.git
cd blurt
uv pip install -e ".[dev]"
pytest
Privacy
Everything runs on your Mac. No network calls, no telemetry, no data collection. Audio files are saved locally to ~/.blurt/audio/ and never leave your device.
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file blurt-0.9.0.tar.gz.
File metadata
- Download URL: blurt-0.9.0.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
07a6f6bb05d8501c7a18c5645cc779d089fee2c7260a59d3c1fe0ca7a05047b0
|
|
| MD5 |
9386a042cc109ca1ec2238b13ed29579
|
|
| BLAKE2b-256 |
9c0f330a7f55c754d4e69de7b6e745ad1c772f336fd9f834115b900bfea933ad
|
Provenance
The following attestation bundles were made for blurt-0.9.0.tar.gz:
Publisher:
publish.yml on satyaborg/blurt
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
blurt-0.9.0.tar.gz -
Subject digest:
07a6f6bb05d8501c7a18c5645cc779d089fee2c7260a59d3c1fe0ca7a05047b0 - Sigstore transparency entry: 2308050032
- Sigstore integration time:
-
Permalink:
satyaborg/blurt@681bbdec9cf2d57d36eb849937ca5b71716b88b1 -
Branch / Tag:
refs/tags/v0.9.0 - Owner: https://github.com/satyaborg
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@681bbdec9cf2d57d36eb849937ca5b71716b88b1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file blurt-0.9.0-py3-none-any.whl.
File metadata
- Download URL: blurt-0.9.0-py3-none-any.whl
- Upload date:
- Size: 25.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
906e058b83c092b3b1a3e7418239e59338dd638200a9cab548908f37018efc24
|
|
| MD5 |
e803b573cf34303cf9c40c20631bd0de
|
|
| BLAKE2b-256 |
bcdb2268642509c95c21721a9d1473726652c89584547adf1746f81a21e87182
|
Provenance
The following attestation bundles were made for blurt-0.9.0-py3-none-any.whl:
Publisher:
publish.yml on satyaborg/blurt
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
blurt-0.9.0-py3-none-any.whl -
Subject digest:
906e058b83c092b3b1a3e7418239e59338dd638200a9cab548908f37018efc24 - Sigstore transparency entry: 2308050074
- Sigstore integration time:
-
Permalink:
satyaborg/blurt@681bbdec9cf2d57d36eb849937ca5b71716b88b1 -
Branch / Tag:
refs/tags/v0.9.0 - Owner: https://github.com/satyaborg
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@681bbdec9cf2d57d36eb849937ca5b71716b88b1 -
Trigger Event:
push
-
Statement type:
