Skip to main content

Local dictation backend for Claude Code (macOS, Apple Silicon) — on-device Whisper, "Hey Claude" wake word, @-file tagging, voice daemon.

Project description

claude_purr — "Hey Claude" voice for Claude Code

Hands-free voice control for Claude Code on macOS (Apple Silicon). Say "Hey Claude", speak, and your words land in the Claude Code prompt — spoken filenames become @file mentions. Fully on-device (WhisperKit on the Apple Neural Engine); nothing leaves your Mac.

Install

  1. Install the claude_purr extension in VS Code or Cursor.
  2. Install the backend once:
    brew install whisperkit-cli pipx
    pipx install claude-purr
    
  3. Reload the editor and grant Microphone permission. The first run downloads the WhisperKit speech model (one time).

Use

Open a terminal, start claude, then say "Hey Claude …". An overlay shows the state — blue listening, red recording, green sent. Click claude_purr in the status bar to pause, stop, or restart.

How it works

Wake word → on-device transcription → @-file tagging → the extension types the command into the active Claude Code terminal. A local daemon owns the microphone and the warm model; the extension starts and manages it.

Diagnostics: claude-purr --doctor.


claude_purr — by DKS-Analytics GmbH · www.dks-analytics.de

Project details


Download files

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

Source Distribution

claude_purr-0.1.1.tar.gz (239.3 kB view details)

Uploaded Source

Built Distribution

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

claude_purr-0.1.1-py3-none-any.whl (239.7 kB view details)

Uploaded Python 3

File details

Details for the file claude_purr-0.1.1.tar.gz.

File metadata

  • Download URL: claude_purr-0.1.1.tar.gz
  • Upload date:
  • Size: 239.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for claude_purr-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c3eda97fa6ca32ffd6c3697c370057c79a1d76c5f7be9fd7dfac0c8243a5e56d
MD5 7433c6ed1f24c8ad0b1f43d06b498d91
BLAKE2b-256 ddb14a4e72b0be7edf6c79f9bdc2366946375085fa5ca8c281ac24e01432c182

See more details on using hashes here.

File details

Details for the file claude_purr-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: claude_purr-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 239.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for claude_purr-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 63e9dc4c40166a33da7d6a53fa81a1d213dc036575470e0fa8fd9a1e8dafc271
MD5 630cc40651a3a03029a33ce2d7852d18
BLAKE2b-256 7b6cd20ef0b9e1b1527b7f03fd953505d2479a341514e49459d7826324b58502

See more details on using hashes here.

Supported by

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