░█▀▄░█░░░█░█░█▀▄░▀█▀
░█▀▄░█░░░█░█░█▀▄░░█░
░▀▀░░▀▀▀░▀▀▀░▀░▀░░▀░

Talk to your coding agents.

PyPI Downloads License

demo

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 Whisper model (~1.6 GB, one-time). 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

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 disk space (~1.6 GB needed in ~/.cache/huggingface/)

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

MIT

Project links

Data verified by PyPI on Jul 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for satyaborg from gravatar.com satyaborg

Credits

Author: Satya Borgohain

GitHub Statistics

Data verified by PyPI on Jul 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

speech-to-text whisper mlx apple-silicon macos voice transcription

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blurt-0.8.9.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

blurt-0.8.9-py3-none-any.whl (25.0 kB view details)

Uploaded Python 3

File details

Details for the file blurt-0.8.9.tar.gz.

File metadata

  • Download URL: blurt-0.8.9.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

Hashes for blurt-0.8.9.tar.gz
Algorithm Hash digest
SHA256 32f71e14b2ddc7d2ccad9e6aadd23a344fc1e0e6a66f32503b708fa981d81691
MD5 b187775516cbac21ed445e6825d49699
BLAKE2b-256 5dae45fce661c6ec4db1527ddb18946c857a8fe0078d554196a990b3c4e1776b

See more details on using hashes here.

Provenance

The following attestation bundles were made for blurt-0.8.9.tar.gz:

Publisher: publish.yml on satyaborg/blurt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file blurt-0.8.9-py3-none-any.whl.

File metadata

  • Download URL: blurt-0.8.9-py3-none-any.whl
  • Upload date:
  • Size: 25.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for blurt-0.8.9-py3-none-any.whl
Algorithm Hash digest
SHA256 33601d50535fcfbd1b07b3297182bf4b76ebd5bfc72f86fa7bab98b352618780
MD5 f64ea45405bac9c7d3c0e2adc0c9f031
BLAKE2b-256 3d3fa8d2b5ac3acc55234491e6425e6a9c73b6b3decff98b0077131612cf9b82

See more details on using hashes here.

Provenance

The following attestation bundles were made for blurt-0.8.9-py3-none-any.whl:

Publisher: publish.yml on satyaborg/blurt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.9.1

2 files

0.9.0

2 files

0.8.11

2 files

0.8.10

2 files

This release

0.8.9 This release

2 files

0.8.8

2 files

0.8.7

2 files

0.8.6

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.5

2 files

0.6.4

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

Yanked

0.4.0

2 files

0.3.9

2 files

0.3.8

2 files

0.3.7

2 files

0.3.6

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page