ferraus models rm

Remove a cached model

Synopsis

ferraus models rm <name> [options]

What it does

Remove a cached model

Examples

Free the disk space

ferraus models rm separate/htdemucs

Remove one cached version and keep any others

ferraus models rm separate/htdemucs@v4-onnx.2026-05-21

Remove a model and report the bytes freed as JSON

ferraus models rm pitch/crepe --json

Options

FlagTypeDefaultMeaning
<name>text—Model name[@version]; without a version every cached version is removed Required.

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
5Model not cached and downloads disabled
6Model download or verification failed
8Cancelled
10Network error
70Internal error (bug)

Common mistakes

  • Expecting human-readable text when scripting: add --json for a stable machine result.

For models

  • MCP tool: ferraus_models_rm
  • Schema: ferraus schema models rm
  • Pipeline: { op: models rm, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "models rm", "defaults": {}}