use-local-whisper

Replace cloud-based voice transcription with local whisper.cpp processing on macOS Apple Silicon.

85|23|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/DingyangLyu/MatClaw --skill use-local-whisper-dingyanglyu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-local-whisper
Source: https://github.com/DingyangLyu/MatClaw/tree/main/.claude/skills/use-local-whisper
Command: npx skills add https://github.com/DingyangLyu/MatClaw --skill use-local-whisper-dingyanglyu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cloud‑based voice transcription relies on external APIs, incurs costs, and requires network access, which limits privacy and offline use. This skill replaces the OpenAI Whisper API with a fully local whisper.cpp pipeline, eliminating API keys and reducing latency.

Core Features & Use Cases

  • On‑device transcription: Uses whisper.cpp and ffmpeg to process audio locally on macOS Apple Silicon.
  • WhatsApp integration: Seamlessly switches the MatClaw WhatsApp channel to the local engine.
  • Automatic setup & verification: Checks dependencies, installs missing tools, validates model files, and updates launchd paths.

Quick Start

Run the use‑local‑whisper skill to enable on‑device voice transcription for WhatsApp messages.

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?

Local voice transcription on macOS uses whisper.cpp and ffmpeg to process WhatsApp audio entirely on-device, eliminating API keys, network access, and cloud latency. The pipeline automatically checks dependencies, validates model files, and updates launchd paths for immediate offline use.

Does local whisper transcription work on macOS Apple Silicon for WhatsApp audio?

Local whisper transcription is designed specifically for macOS Apple Silicon to process WhatsApp voice messages. It leverages the hardware capabilities to run whisper.cpp and ffmpeg directly on-device, ensuring privacy and offline functionality without relying on external cloud services.

What do I need to set up whisper.cpp for offline voice transcription?

Offline voice transcription requires whisper.cpp, ffmpeg, and a GGML model file accessible to the service. The setup process automatically verifies these dependencies, installs missing tools, and updates launchd paths to ensure the local pipeline functions correctly.

Why use local whisper.cpp instead of the OpenAI Whisper API for voice transcription?

Local whisper.cpp replaces the OpenAI Whisper API to eliminate external API costs and network access requirements. This on-device approach maximizes privacy, reduces latency, and allows offline voice transcription for WhatsApp messages without needing API keys.

Can I run voice transcription offline if the MatClaw WhatsApp channel switches to the local engine?

Running voice transcription offline is possible when the MatClaw WhatsApp channel is switched to the local whisper.cpp engine. This setup processes audio locally on macOS Apple Silicon, ensuring full functionality without network connectivity or external API dependencies.