use-local-whisper

Switch voice transcription from the OpenAI Whisper API to local whisper.cpp on Apple Silicon.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill use-local-whisper-theowenyoung
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-local-whisper
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/use-local-whisper
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill use-local-whisper-theowenyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Switches voice transcription from the OpenAI Whisper API to a local whisper.cpp on-device — no API key, no network usage.

Core Features & Use Cases

  • Local on-device transcription using whisper.cpp (whisper-cli) on Apple Silicon.
  • WhatsApp channel support (extensible to other channels with additional audio-downloading logic).
  • No API keys or cloud calls required; easy setup with a model in data/models.

Quick Start

Apply the voice-transcription skill, install whisper-cpp and ffmpeg, download a GGML model to data/models, and run NanoClaw to transcribe WhatsApp voice messages locally.

Frequently Asked Questions about use-local-whisper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe WhatsApp voice messages locally on macOS without an API key?▼

Local transcription of WhatsApp voice messages is achieved by switching to whisper.cpp with a modified transcription.ts file, requiring no API key or network connection. You simply install whisper-cli and ffmpeg, then place a GGML model in the data/models directory.

Can I use whisper.cpp for on-device audio processing on Apple Silicon?▼

Yes, on-device audio processing with whisper.cpp is specifically supported on Apple Silicon macOS. It uses the whisper-cli executable to run transcription locally without sending audio data to the cloud.

What do I need to install to set up local whisper.cpp transcription?▼

To set up local transcription, you need to install whisper-cpp and ffmpeg on your system. Additionally, you must download a GGML model and place it in the data/models directory before running the transcription process.

Does local whisper transcription work with channels other than WhatsApp?▼

Local whisper transcription currently supports WhatsApp directly, but it can be extended to other channels. To support additional platforms, you must implement channel-specific audio download logic to feed audio files into the transcription pipeline.

Local whisper.cpp transcription not working, what prerequisites am I missing?▼

Local transcription fails if whisper-cli is not installed, ffmpeg is not available in your system path, or the required GGML model is missing from the data/models directory. Ensure your transcription.ts file is modified to call whisper-cli instead of the OpenAI API.