ferraus models list
List registry models: version, task, size, license, cached, and which tiers use them
Synopsis
ferraus models list [options]
What it does
Shows every model in the active registry. Models whose license forbids commercial use, or that have no clear license, are flagged and never used by default tiers; unverified entries have no recorded checksum yet and are refused by downloads unless FERRAUS_ALLOW_UNVERIFIED=1.
Examples
Separation models and the tiers that use them
ferraus models list --task separate
Only the models already downloaded to this machine
ferraus models list --cached
Pitch-tracker models with size, license, and cache state as JSON
ferraus models list --task pitch --json
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
--task | text | — | Only models for this task (separate, denoise, pitch, transcribe, omr) |
--cached | flag | — | Only models present in the local cache |
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_list - Schema:
ferraus schema models list - Pipeline:
{ op: models list, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "models list", "defaults": {}}