whisper-transcribe-setup
Build the whisper-transcribe Rust binary from src/whisper-transcribe/ in this repository and download the default Whisper model. The binary and model are the shared backend for /connect0459-agent-skills:youtube-transcribe-local and /connect0459-agent-skills:youtube-transcribe-transcribe-youtube.
Script
<skill-path>/scripts/setup [--model NAME] [--no-smoke-test]
Defaults:
- Binary install path:
~/.local/bin/whisper-transcribe - Model directory:
~/.local/share/whisper-transcribe/models/ - Model:
large-v3-turbo(~809 MB quantised, multilingual, fast on Apple Silicon Metal)
Workflow
The script runs these steps in order. Each step prints a ==> step name header.
- Prerequisite check. Verifies
cargo,cmake,clang,ffmpeg, andyt-dlpare on PATH. Exits with install hints if any are missing. - Build. Runs
cargo build --releaseinsrc/whisper-transcribe/. Skipped when the installed binary is newer than all source files (idempotent). Copiestarget/release/whisper-transcribeto~/.local/bin/. - Model download. Downloads
ggml-<model>.binfrom HuggingFace viacurl. Skipped when the model file already exists. - Smoke tests. Always run — verifies the install produces correct output, not just that it built.
- English: fetches
samples/jfk.wavfrom the whisper.cpp upstream repository; checks transcript containsaskandcountry. - Japanese: generates a clip via
say -v Kyokoand converts withffmpeg; checks transcript contains天気and明日.
- English: fetches
Prerequisites
The script checks and reports all missing tools before doing any work:
cargo— Rust toolchain (install viacurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh)cmake— required bywhisper-sysbuild script (brew install cmakeon macOS)clang— C++ compiler for whisper.cpp FFI (xcode-select --installon macOS)ffmpeg— audio transcoding for local transcription (brew install ffmpeg)yt-dlp— YouTube download for the transcribe-youtube skill (brew install yt-dlp)
cmake and clang are toolchain dependencies — the user authors only Rust code; the C++ compilation happens inside cargo build via whisper-sys.
Disk
- Build artifacts under
src/whisper-transcribe/target/: ~400 MB (in.gitignore) - Default model
ggml-large-v3-turbo.bin: ~809 MB - Plan for ~1.2 GB total on first setup; subsequent runs are near instant.
After setup
- Binary:
~/.local/bin/whisper-transcribe - Model:
~/.local/share/whisper-transcribe/models/ggml-large-v3-turbo.bin
Use /connect0459-agent-skills:youtube-transcribe-local for local file transcription, or /connect0459-agent-skills:youtube-transcribe-transcribe-youtube for the full YouTube workflow.