inference

unload

Unload cached inference models.

strata inference unload

wire inference_unload

Removes cached model engines from the runtime to free memory. Pass a model spec to unload one entry, or omit it to unload every cached generation, embedding, and ranking model. The result reports whether any cached entry was actually removed. This affects only the in-memory runtime cache; it never deletes downloaded model files from disk.

To see the complete help for this command, run:

strata inference unload --help

Example

Evict cached models from the runtime (a no-op when nothing is loaded).

strata inference unload

Parameters

NameTypeRequiredDescription
modelstring or nullnoOptional model spec.

Returns

UnloadResult

  • dataobject
  • typestring

Errors

Recover by code. Retry policy and commit outcome come from the shipped error registry.

CodeRetryCommit outcome
failed_precondition.engine.runtime_closednevernot_started
not_found.engine.branchnevernot_applicable
← All 11 Inference commands

agents: this page as markdown → /docs/reference/inference/unload.md