Ster
Ster/Docs

ster tune inspect

Validate a LoRA adapter artifact and print everything it knows about itself, including every tensor shape and the run that trained it, without loading a model.

Invocation and purpose#

text
ster tune inspect <ARTIFACT>

Loads the adapter pair through the same validation ster generate --adapter uses and pretty-prints the whole document. No model is loaded — auditing which layers and projections an adapter touches should not cost a multi-gigabyte mmap. This is the adapter counterpart of `ster vector inspect`, which does the same for a steering artifact.

Inputs and options#

InputRequiredMeaning
<ARTIFACT>yesPath to the adapter safetensors; the JSON sidecar is derived from it by replacing the extension, and both files must be present.

There are no options. The tensors are read onto the CPU whatever device trained them.

Output and state#

Stdout is a pretty JSON document under one adapter key: schema_version, product, model, model_revision, rank, alpha, the derived scale (alpha / rank), targets, layers, hidden_size, then tensors — one name and shape record per factor — and finally train, the report recorded by the run that produced the adapter. Nothing is written.

scale is computed rather than stored, so an inspected artifact shows the multiplier a forward pass would actually apply.

Refusals#

  • A missing artifact is refused as failed to read adapter <PATH>, naming the path that was asked for rather than the sidecar derived from it.
  • A weights file whose sidecar is absent is refused as adapter <PATH> has no sidecar at <SIDECAR>; the pair is written together and must travel together.
  • Read and parse failures are failed to read adapter sidecar <PATH>, invalid adapter sidecar JSON in <PATH>, and failed to read adapter weights <PATH>.
  • Every validation refusal in LoRA adapter applies here, since inspection is a full validation.
  • Failures wrap the refusal the way ster vector inspect does: Error: failed to inspect calm.lora.safetensors … Caused by: adapter artifact belongs to product "other", not Ster.