ferraus models pull
Download models with resume and SHA-256 verification
Synopsis
ferraus models pull <name> [options]
What it does
Downloads each named model (name or name@version) into the cache, resuming partial downloads and verifying the SHA-256 recorded in the signed registry. The size and license are printed before fetching. --all-for pulls every model a command's tiers need.
Examples
Fetch the fast separation model
ferraus models pull separate/htdemucs
Everything the fast separation tier needs
ferraus models pull --all-for separate --tier fast
Fetch two models at once without the confirmation prompt
ferraus models pull denoise/dfn3 pitch/crepe -y
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
<name> | text | — | Model name[@version]; several allowed Repeatable. |
--all-for | text | — | Pull every model the tiers of this command need (e.g. separate) |
--tier | text | — | With --all-for: only this tier |
--accept-license | flag | — | Accept a research-only, non-commercial, or unclear license for the named models |
Global options
Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Processing failed |
| 2 | Usage or parameter error |
| 3 | Input missing or unreadable |
| 5 | Model not cached and downloads disabled |
| 6 | Model download or verification failed |
| 8 | Cancelled |
| 10 | Network error |
| 70 | Internal error (bug) |
Common mistakes
- Expecting human-readable text when scripting: add
--jsonfor a stable machine result.
For models
- MCP tool:
ferraus_models_pull - Schema:
ferraus schema models pull - Pipeline:
{ op: models pull, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "models pull", "defaults": {}}