use-local-whisper

Transcribe WhatsApp voice notes locally using whisper.cpp on Apple Silicon.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/LIMITLESS-LONGEVITY/limitless --skill use-local-whisper-limitless-longevity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-local-whisper
Source: https://github.com/LIMITLESS-LONGEVITY/limitless/tree/main/apps/nanoclaw/.claude/skills/use-local-whisper
Command: npx skills add https://github.com/LIMITLESS-LONGEVITY/limitless --skill use-local-whisper-limitless-longevity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a way to transcribe voice messages locally on-device to avoid using OpenAI's Whisper API, removing the need for network calls, API keys, and per-call costs while preserving privacy.

Core Features & Use Cases

  • Local, offline transcription: Switches the voice transcription pipeline to use whisper.cpp (whisper-cli) running on Apple Silicon so audio is processed entirely on the machine.
  • Service integration: Modifies src/transcription.ts to call the local binary and includes guidance for ensuring the launchd PATH contains Homebrew binaries so the background service can run the tools.
  • WhatsApp-focused: Built for WhatsApp voice notes using Baileys audio download logic; other channels require custom audio-download code before use.
  • Use Case: Run on a macOS M1/M2 device to transcribe team voice notes in WhatsApp without sending audio to external services.

Quick Start

Install whisper-cpp and ffmpeg, place a GGML model file in data/models, ensure the voice-transcription skill is applied first, and merge or apply the local-whisper changes so src/transcription.ts uses whisper-cli for WhatsApp voice notes.

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 offline on macOS?

To transcribe WhatsApp voice notes offline on macOS, you can use whisper.cpp on Apple Silicon. This approach processes audio entirely on-device, eliminating network calls and preserving privacy without needing external API keys.

Can I use whisper.cpp instead of the OpenAI Whisper API for local transcription?

Yes, whisper.cpp replaces the OpenAI Whisper API for local transcription. By running the whisper-cli binary on your machine, you avoid per-call costs and external network dependencies while processing audio entirely on-device.

What do I need to run whisper.cpp for WhatsApp voice transcription?

Running whisper.cpp for WhatsApp voice transcription requires a whisper-cli binary, ffmpeg, and a GGML model file placed in the data/models directory. You also need to adjust the launchd PATH to include Homebrew binaries for the background service.

Does local whisper transcription work on non-Apple Silicon Macs?

The local whisper transcription setup is specifically built for macOS Apple Silicon, such as M1 or M2 devices. Using it on non-Apple Silicon hardware may require different compilation steps or configurations not covered by this integration.

Why does my launchd service fail to run whisper-cli for transcription?

Your launchd service fails to run whisper-cli because the background service PATH likely lacks Homebrew binaries. You must adjust the launchd PATH environment variables so the service can successfully locate and execute the local transcription tools.

Can I use this offline transcription setup for voice messages outside WhatsApp?

This offline transcription setup is specifically built for WhatsApp voice notes using Baileys audio download logic. To transcribe voice messages from other channels, you must write custom audio-download code before applying the whisper.cpp integration.