Local speech-to-text via Handy app (push-to-talk) and NeMo CLI scripts. Parakeet V3: 25 languages, auto-detection, ~30x realtime on M4 Max, 6% WER. This skill should be used when transcribing audio files or dictating voice input.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Local speech-to-text via Handy app (push-to-talk) and NeMo CLI scripts. Parakeet V3: 25 languages, auto-detection, ~30x realtime on M4 Max, 6% WER. This skill should be used when transcribing audio files or dictating voice input.
argument-hint
["audio-file | \"dictate\" | \"check\""]
tools
["Bash","Read","Write"]
Parakeet Dictation Skill
Local speech-to-text powered by NVIDIA Parakeet TDT 0.6B V3 (~600MB model, 100% offline).
Two Modes
1. Handy App (Primary — Push-to-Talk into Any Text Field)
Handy is a free, open-source Tauri app (Rust + React) providing
push-to-talk dictation with Parakeet V3 built in. Inference via
transcribe-rs (ONNX Runtime, int8 quantized).
brew install --cask handy
Default hotkey: ⌥Space (Option-Space) on macOS, Ctrl-Space on Windows/Linux
Modes: Push-to-talk (hold) or toggle (press to start/stop)
Select Parakeet V3 in Settings → Models (auto-downloads ~478MB)
Record from microphone until Enter is pressed, then transcribe.
Check Installation
/parakeet check
Verify Parakeet is properly installed and model can load.
Setup
Handy (Push-to-Talk UI)
brew install --cask handy
Launch from Applications, select Parakeet V3 model, configure hotkey.
CLI Scripts (Prerequisites)
Parakeet Dictate repo at ~/Programming/parakeet-dictate/ with Python venv
Install dependencies:
cd ~/Programming/parakeet-dictate
uv venv && uv pip install -r requirements.txt
(Optional) Set custom path: export PARAKEET_HOME=/path/to/parakeet-dictate
Implementation
When this skill is invoked:
For audio files: Run the transcription script
cd ~/.claude/skills/parakeet/scripts && \
${PARAKEET_HOME:-~/Programming/parakeet-dictate}/.venv/bin/python transcribe.py "<filepath>"
For live dictation: Run the dictation script
cd ~/.claude/skills/parakeet/scripts && \
${PARAKEET_HOME:-~/Programming/parakeet-dictate}/.venv/bin/python dictate.py
For checking setup: Run the check script
cd ~/.claude/skills/parakeet/scripts && \
${PARAKEET_HOME:-~/Programming/parakeet-dictate}/.venv/bin/python check_setup.py
3. Server Mode (OpenAI-Compatible STT for Takopi)
An OpenAI-compatible transcription server for integration with Takopi and other
API clients. Exposes POST /v1/audio/transcriptions wrapping the NeMo CLI.
uv run --with fastapi,uvicorn,python-multipart \
~/.claude/skills/parakeet/scripts/parakeet_server.py --port 8384
