inference
models.pull
Download an inference model locally.
strata inference models pulldb.ai.models.pull(model: 'str') -> 'Any'wire inference_models_pull
Resolves a catalog name or model spec and downloads the model artifact into the local model directory, returning the resolved local path. A model that is already present is not downloaded again: the command returns its path in every build, with or without network access. Honors `STRATA_MODELS_DIR` for the destination and `STRATA_HF_ENDPOINT` and `STRATA_HF_TOKEN` (or `HF_TOKEN`) for gated HuggingFace repositories. The spec is resolved before anything else is checked: a malformed spec returns `inference.invalid_request`, a cloud provider spec returns `inference.unsupported_operation` (there is nothing to download), and a name that is not in the catalog returns `inference.missing_model`. A missing model is downloaded only when the runtime has network access and the build can download; otherwise the command returns `inference.download_disabled`.
To see the complete help for this command, run:
strata inference models pull --helphelp(db.ai.models.pull)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| model | string | yes | Model spec or catalog name. |
Returns
PullModelOutput
- dataPullModelOutput
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| inference.invalid_request | never | not_applicable |
| inference.unsupported_operation | never | not_applicable |
| inference.download_disabled | after_state_change | not_applicable |
| inference.missing_model | after_state_change | not_applicable |
| inference.unknown_model | never | not_applicable |
| inference.download_failed | same_request | not_applicable |
| inference.download_verification_failed | after_state_change | not_applicable |
| inference.io_failure | after_state_change | not_applicable |
| inference.registry_corrupt | never | not_applicable |