Manage Whisper test models
Testing & QualityManage Whisper test models is an Agent Skill for testing & quality published in the sandrohanea/whisper.net repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when tests need deterministic model files, model downloads fail, or WHISPER_TEST_MODEL_PATH is involved.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/sandrohanea/whisper.net/blob/HEAD/.github/skills/manage-whisper-test-models/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/manage-whisper-test-models, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Manage Whisper test models
Use this skill when tests fail because model files are missing, the environment cannot download models, or a task touches model download/test fixture behavior.
Model path contract
WHISPER_TEST_MODEL_PATH must point to a directory that contains test model files, not to a single model file. The test helper expects file names like:
ggml-tiny-noquantization.bin
ggml-tiny-q5_0.bin
Do not set WHISPER_TEST_MODEL_PATH to runtimes/ unless those ggml-*.bin files are present there.
Populate the model cache
Use the repository tool to download the models expected by tests:
$env:WHISPER_TEST_MODEL_PATH = "$PWD\.test-models"
dotnet run --project .\tools\DownloadModelForTests\DownloadModelForTests.csproj
dotnet test .\Whisper.net.slnx --logger "trx"
Remove-Item Env:\WHISPER_TEST_MODEL_PATH
Keep .test-models/ or any other downloaded model cache out of source control.
Hugging Face token
Some model downloads may require authentication. If the environment provides HF_TOKEN, preserve and pass it through rather than hardcoding tokens or adding tokens to config files.
Troubleshooting
- If tests fail before downloading, check that
WHISPER_TEST_MODEL_PATHpoints to a writable directory. - If tests fail after downloading, verify both expected file names exist in the directory.
- If native library loading fails, use runtime validation skills instead; model files and native runtimes are separate inputs.