use-local-whisper

Switch WhatsApp transcription from the Whisper API to local whisper.cpp.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It replaces costly, network-dependent Whisper API transcription with fully on-device speech-to-text so voice notes can be transcribed privately and without API keys.

Core Features & Use Cases

  • Switches transcription engine to whisper.cpp: Redirects the WhatsApp transcription pipeline from the Whisper API to a local whisper-cli binary.
  • Runs fully offline: Uses local model files (GGML) so transcription requires no external calls, reducing cost and improving privacy.
  • Practical WhatsApp-first workflow: Designed for WhatsApp audio download via Baileys types, making it suitable for group voice-note transcription in NanoClaw.

Quick Start

Apply this skill after the voice-transcription skill is already set up for WhatsApp, then tell NanoClaw to transcribe a voice note so the agent returns the transcript as a [Voice: ...] message.

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 notes locally without an API?

You can transcribe WhatsApp voice notes locally by switching from the Whisper API to a local whisper.cpp workflow. This redirects the transcription pipeline to use a local whisper-cli binary, requiring ffmpeg and a downloaded GGML model to process audio entirely on-device.

What do I need to run offline speech-to-text for WhatsApp audio?

Running offline speech-to-text requires installing whisper-cli and ffmpeg, downloading a GGML model file, and ensuring the service PATH includes Homebrew binaries. The WhatsApp transcription code must also be updated to invoke the local whisper-cli binary.

Can I use whisper.cpp for WhatsApp voice transcription in a Docker sandbox?

Yes, whisper.cpp can be used for WhatsApp voice transcription in a Docker sandbox. The skill is designed for NanoClaw agent deployments and applies on-device speech-to-text, provided the sandbox PATH is configured to include the necessary Homebrew binaries.

Why does local whisper-cli transcription fail to find my binary in the service PATH?

Local whisper-cli transcription fails when the service PATH does not include Homebrew binaries. You must ensure the PATH environment variable for the transcription service is updated to locate the installed whisper-cli and ffmpeg executables correctly.

Is local whisper.cpp transcription better than the Whisper API for WhatsApp privacy?

Local whisper.cpp transcription improves WhatsApp privacy by running fully offline with no external network calls. It eliminates the need for API keys and prevents audio data from leaving the device, making it suitable for private group voice-note transcription.

How do I set up a whisper.cpp model for offline WhatsApp voice transcription?

To set up a whisper.cpp model for offline WhatsApp voice transcription, you need to download a GGML model file. After installing whisper-cli and ffmpeg, update the WhatsApp transcription code to invoke whisper-cli using this local model file.