whisper.cpp/examples
Dominic Dones 1c53e05aee examples: make -hf resolve a cached model without --hf-file
Change the empty --hf-file branch of whisper_hf_resolve_model to be
cache-first and refuse ambiguity rather than pick the repo's first
ggml-*.bin. With no -hff: exactly one cached ggml-*.bin resolves it
(no network); more than one errors and lists the cached files; a cold
cache errors and lists the repo's available models instead of silently
downloading. This makes "download once with -hff, then just -hf" work.

Unlike llama.cpp's -hf <user>/<model>[:quant] default-quant pick
(find_best_model), whisper repos are many-models-one-repo with no
meaningful default, so we key off the cache and error+list on ambiguity.
The explicit -hff path (download-first, cache fall-back) is unchanged.

whisper_hf_resolve_model now prints a specific diagnostic for every
failure mode, so cli.cpp no longer prints its own generic (and now
inaccurate) "not found in HF cache" line; it just returns exit 3.

tests/test-hf-resolve.sh gains single-cached (-hf alone -> exit 0) and
multi-cached (-hf alone -> exit 3 + "multiple models cached" + list)
cases, and the missing-file assertion matches the new message.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-02 16:35:52 -04:00
..
addon.node ci, examples : add package-lock.json to examples addon node (#3919) 2026-07-01 09:04:21 +02:00
bench bench : sync submit-results URL to ggml-org (#3769) 2026-04-20 07:12:57 +02:00
bench.wasm bench : sync submit-results URL to ggml-org (#3769) 2026-04-20 07:12:57 +02:00
cli examples: make -hf resolve a cached model without --hf-file 2026-07-02 16:35:52 -04:00
command whisper : enable flash attention by default (#3441) 2025-09-30 15:47:20 +03:00
command.wasm examples : add wchess.wasm to wasm examples build (#3443) 2025-09-30 16:23:01 +02:00
deprecation-warning examples : add WHISPER_SDL2 check to deprecation executables (#2911) 2025-03-20 18:36:02 +01:00
lsp examples : fix executable example targets (#3600) 2026-01-13 08:08:18 +01:00
parakeet-cli examples : update model names in parakeet-cli README.md [no ci] (#3906) 2026-06-23 09:12:31 +02:00
parakeet-quantize parakeet : add support for NVIDIA Parakeet (#3735) 2026-06-16 20:44:10 +02:00
python readme : remove invalid flag from Python example (#2396) 2024-08-30 14:00:38 +03:00
quantize examples : fix executable example targets (#3600) 2026-01-13 08:08:18 +01:00
server server : merge split utf-8 token text in verbose json (#3850) 2026-06-02 13:10:27 +02:00
stream whisper : enable flash attention by default (#3441) 2025-09-30 15:47:20 +03:00
stream.wasm examples : add wchess.wasm to wasm examples build (#3443) 2025-09-30 16:23:01 +02:00
sycl sycl: fix example build (#2570) 2024-11-18 14:57:23 +02:00
talk-llama talk-llama : sync llama.cpp 2026-06-26 16:03:57 +03:00
vad-speech-segments examples : fix argument flag for min speech duration in VAD (#3907) 2026-06-26 08:09:03 +02:00
wchess wchess : fix link [no ci] 2025-09-30 21:28:03 +03:00
whisper.android examples : Improved inference performance of Android example project (#3913) 2026-06-30 12:12:04 +02:00
whisper.android.java examples : Improved inference performance of Android example project (#3913) 2026-06-30 12:12:04 +02:00
whisper.nvim rename : ggerganov -> ggml-org (#3005) 2025-04-04 16:11:52 +03:00
whisper.objc docs : update README.md for whisper.objc app (#2569) 2025-05-13 06:03:50 +02:00
whisper.swiftui examples : clarify Core ML encoder model usage [no ci] (#2987) 2025-04-02 08:32:14 +02:00
whisper.wasm wasm : fix Hebrew ID (#3487) 2025-10-27 08:49:32 +02:00
CMakeLists.txt examples: add HF HTTPS download with cache fall-back to whisper-cli 2026-07-02 16:20:52 -04:00
coi-serviceworker.js ci : add github pages workflow for wasm examples (#2969) 2025-03-31 11:34:40 +02:00
common-ggml.cpp examples : update to Q1_0 2026-05-01 13:07:33 +03:00
common-ggml.h
common-sdl.cpp common : more general m_audio_len update logic (#2855) 2025-03-07 10:10:03 +02:00
common-sdl.h sdl : fix audio callback (#1523) 2023-11-20 13:16:38 +02:00
common-whisper.cpp examples: make -hf resolve a cached model without --hf-file 2026-07-02 16:35:52 -04:00
common-whisper.h examples: add HF cache model resolution to whisper-cli (-hf/-hff) 2026-07-02 15:52:48 -04:00
common.cpp whisper: remove MSVC warnings pragmas (#3090) 2025-05-05 13:09:35 +02:00
common.h examples : add --print-confidence option to cli (#3150) 2025-05-14 19:21:48 +02:00
ffmpeg-transcode.cpp common : pass sample rate to `ffmpeg_decode_audio()` 2026-05-31 15:49:13 +03:00
generate-karaoke.sh examples : use miniaudio for direct decoding flac, mp3, ogg and wav (#2759) 2025-02-27 09:06:54 +02:00
grammar-parser.cpp whisper : reorganize source code + improve CMake (#2256) 2024-06-26 19:34:09 +03:00
grammar-parser.h whisper : add grammar-based sampling (#1229) 2023-11-13 10:51:34 +02:00
helpers.js js : remove un-needed request header from fetchRemote (#2119) 2024-05-13 15:13:19 +03:00
hf-cache.cpp examples: add HF HTTPS download with cache fall-back to whisper-cli 2026-07-02 16:20:52 -04:00
hf-cache.h examples: add HF HTTPS download with cache fall-back to whisper-cli 2026-07-02 16:20:52 -04:00
http.h examples: add HF cache model resolution to whisper-cli (-hf/-hff) 2026-07-02 15:52:48 -04:00
json.hpp examples : clean up common code (#1871) 2024-02-19 10:50:15 +02:00
livestream.sh rename : ggerganov -> ggml-org (#3005) 2025-04-04 16:11:52 +03:00
miniaudio.h examples : update miniaudio library to 0.11.24 (#3672) 2026-02-27 11:15:15 +01:00
server.py examples : add wchess.wasm to wasm examples build (#3443) 2025-09-30 16:23:01 +02:00
stb_vorbis.c examples : use miniaudio for direct decoding flac, mp3, ogg and wav (#2759) 2025-02-27 09:06:54 +02:00
twitch.sh rename : ggerganov -> ggml-org (#3005) 2025-04-04 16:11:52 +03:00
yt-wsp.sh examples : update usage/help in yt-wsp.sh (#3251) 2025-06-16 12:21:16 +02:00