{"slug":"whisper-cpp","name":"whisper.cpp","kind":"runbook","what":"Local speech-to-text with Metal GPU acceleration and optional Core ML on Apple silicon.","page":"https://insidethemachine.ai/setups/whisper-cpp","status":"docs-checked","status_label":"Not run: commands checked against the official docs only","status_note":"Commands checked against the official docs on 2026-10-15. Not run end to end.","wrapper":"The wrapper scripts are generated from the site data. Every .sh passed bash -n and shellcheck and ran in plan mode on Linux (Debian 13). Every .ps1 passed the PowerShell parser and chat.ps1 ran in plan, verify and rollback mode under PowerShell 7 on Linux with Windows calls mocked. Not run on macOS or real Windows.","wrapper_tested":null,"sh":"https://insidethemachine.ai/install/whisper-cpp.sh","ps1":null,"md":"https://insidethemachine.ai/install/whisper-cpp.md","json":"https://insidethemachine.ai/install/whisper-cpp.json","one_liner":"curl -fsSL https://insidethemachine.ai/install/whisper-cpp.sh | bash","one_liner_windows":null,"actions":{"install":"curl -fsSL https://insidethemachine.ai/install/whisper-cpp.sh | bash","plan":"curl -fsSL https://insidethemachine.ai/install/whisper-cpp.sh | bash -s -- plan","verify":"curl -fsSL https://insidethemachine.ai/install/whisper-cpp.sh | bash -s -- verify","rollback":"curl -fsSL https://insidethemachine.ai/install/whisper-cpp.sh | bash -s -- rollback --yes"},"env":{"ITM_RAM":"memory in GB instead of detecting it"},"model_by_memory_gb":null,"low_memory":null,"platforms":{"macos":{"install":[{"title":"Install whisper.cpp","lines":[{"k":"mac","c":"xcode-select --install   # skip if already installed"},{"k":"mac","c":"brew install cmake"},{"k":"run","c":"git clone https://github.com/ggml-org/whisper.cpp.git && cd whisper.cpp"},{"k":"run","c":"sh ./models/download-ggml-model.sh base.en"},{"k":"run","c":"cmake -B build && cmake --build build -j --config Release"}]},{"title":"Configure (your choices)","lines":[{"k":"note","c":"optional: Core ML encoder on the Apple Neural Engine; see the README's 'Core ML support' section"}]}],"verify":[{"run":"./build/bin/whisper-cli -f samples/jfk.wav","expect":"prints a transcript of the bundled JFK sample"}],"rollback":[{"k":"run","c":"rm -rf whisper.cpp"}]},"linux":{"install":[{"title":"Install whisper.cpp","lines":[{"k":"run","c":"git clone https://github.com/ggml-org/whisper.cpp.git && cd whisper.cpp && sh ./models/download-ggml-model.sh base.en && cmake -B build && cmake --build build -j --config Release"}]},{"title":"Configure (your choices)","lines":[{"k":"note","c":"optional: Core ML encoder on the Apple Neural Engine; see the README's 'Core ML support' section"}]}],"verify":[{"run":"./build/bin/whisper-cli -f samples/jfk.wav","expect":"prints a transcript of the bundled JFK sample"}],"rollback":[{"k":"run","c":"rm -rf whisper.cpp"}]},"windows":null}}