Documentation

CLI reference / Binary and models

cumaru model

List, download and enable, or release the optional local context encoder.

Synopsis

cumaru model list
cumaru model pull <name>
cumaru model release

Arguments and options

Argument or optionMeaning
listRead the fixed model catalog from GitHub main; print names, sizes, and licenses.
pull <name>Download, verify, and enable a catalog model, or reuse a verified local package.
releaseDisable the cached encoder without deleting files; context uses the lightweight scorer.

Side effects

  • Writes: pull publishes a package under ~/.cumaru/<name>/. release writes an empty .released marker. No project files change.
  • Network: list and pull read GitHub main; pull downloads about 35 MB for bge-micro-v2. release is offline.

Behavior

  • The catalog currently contains only bge-micro-v2. Arbitrary model IDs, URLs, and local imports are not supported.
  • pull verifies sizes and SHA-256 before publishing. An existing invalid or different package is rejected and kept.
  • Nothing downloads automatically; context never downloads.

Example

cumaru model list

Failures

  • A missing catalog or network failure is an error. Download or verification failures create no cache state.

Sources: docs/model.md; cumaru model --help of CLI 0.15.3.

Back to all commands