openai-whisper

Transcribe audio files to text locally using the Whisper CLI.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill openai-whisper-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-whisper
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/openai-whisper
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill openai-whisper-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai-whisper.

What problem does it solve? It converts speech in audio files into written text entirely on your local machine, without sending recordings to a cloud API or requiring an API key. ## Core Features & Use Cases - Local Transcription: Run the whisper CLI on audio files like MP3 or M4A to produce plain text output. - Translation to English: Use the translate task to generate SRT subtitles in English from non-English audio. - Model Size Control: Choose smaller models for speed or larger models for accuracy, with models cached in ~/.cache/whisper after first download. - Use Case: Record a meeting as an M4A file, then transcribe it locally into a text file for notes without uploading the recording anywhere. ## Quick Start Transcribe the attached audio file meeting.mp3 to a text file using the whisper CLI with the medium model.

Frequently Asked Questions about openai-whisper

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

FAQPage Schema
How do I transcribe an audio file with Whisper CLI?

Run whisper followed by the audio file path, for example: whisper /path/audio.mp3 --model medium --output_format txt --output_dir . The transcript is written as a text file to the output directory.

How to translate foreign language audio to English subtitles?

Use the translate task with the whisper CLI: whisper /path/audio.m4a --task translate --output_format srt. This generates English SRT subtitle files from non-English speech.

Does OpenAI Whisper require an API key or internet connection?

No API key is needed because Whisper runs entirely locally. Internet is only required once to download the model files, which are cached in ~/.cache/whisper for subsequent offline runs.

Which Whisper model size should I use for transcription?

Use smaller models for faster transcription and larger models for better accuracy. On this install the default model is turbo, and you can override it with the --model flag, such as --model medium.

Why is the first Whisper transcription run slow?

The first run downloads the selected model weights to ~/.cache/whisper, which takes time depending on model size. Later runs reuse the cached model and start transcribing immediately.