What each message means
If it keeps failing
1
Check you have the disk space
Models are large, and a download that dies part way through is usually a
full disk. The larger Whisper models in particular need several gigabytes
free.
2
Try a smaller model
If a small model downloads and a large one doesn’t, that’s disk space or a
connection dropping over a long transfer — not a broken installation.
3
Try a different network
Corporate networks, VPNs and DNS filters block the model hosts more often
than they block anything else we use, because the files come from
huggingface.co and GitHub rather than from us.4
Delete the model and start again
In the model picker, delete the partial model, then download it fresh. That
clears a corrupted partial file, which retrying alone won’t always fix.
On a managed network
Model downloads need hosts that cloud transcription doesn’t, so they can fail on a network where everything else works. Your IT team needs:huggingface.cocdn-lfs.huggingface.co,cdn-lfs-us-1.huggingface.cogithub.com,objects.githubusercontent.com
FAQ
Can I use OpenWhispr while a model downloads?
Can I use OpenWhispr while a model downloads?
Yes — OpenWhispr Cloud works throughout, so you can keep dictating.
Do I need to download a model at all?
Do I need to download a model at all?
Only for local processing. Cloud transcription needs nothing downloaded.
Cloud vs local covers the trade-off.
Where do models go, and how much space do they use?
Where do models go, and how much space do they use?
They’re stored on your machine, and the model picker shows each one’s size
before you download it. You can delete any of them from the same place.
It downloads every time I restart.
It downloads every time I restart.
That points at the install step failing rather than the download — the file
never lands where the app expects it. Send us a debug log; see
how.