Command
vraven explain
Explain one saved PyTorch model invocation and write one report
Minimal form
vraven explain <model>Arguments and options
| Option | Meaning | Default |
|---|---|---|
model | PyTorch model file | None |
--model-format | Model storage format. VRAVEN instrumentation supports state_dict and trusted pickle models; TorchScript can be loaded but cannot expose PyTorch hooks. | state_dict |
--model-factory, --factory | Import path such as my_project.models:Classifier | None |
--factory-kwargs | JSON object passed to the model factory | {} |
--state-dict-key | — | None |
--strip-prefix | — | None |
--device | — | cpu |
--non-strict | — | False |
--trusted-model | Allow Python-pickle model loading | False |
--input | Model input as .npy, .npz or a trusted tensor-only .pt/.pth file | None |
--target | Target class index | None |
--mode | — | gradient |
--class-names | Comma-separated class labels | None |
--module-policy | — | leaf |
--include-module-types | Comma-separated module types | None |
--exclude-module-types | Comma-separated module types | None |
--include-name-patterns | Comma-separated layer-name patterns | None |
--exclude-name-patterns | Comma-separated layer-name patterns | None |
--max-layers | — | 256 |
--max-units | — | 128 |
--representation-size | — | 64 |
--max-attention-tokens | — | 128 |
--histogram-bins | — | 32 |
--no-auto-move-inputs | — | False |
--no-entropy | — | False |
--no-representations | — | False |
--no-unit-profiles | — | False |
--no-attention | — | False |
--no-input-attribution | — | False |
--capture-full-tensors | — | False |
--no-timing | — | False |
--causal-top-k | — | 3 |
--causal-strategy | — | zero |
--causal-scale | — | 0.0 |
--seed | — | 17 |
--output-path | Dot path to logits in structured output | None |
--non-strict-capture | Continue when an individual capture operation is unsupported | False |
--report-format | Write exactly one report in the selected format (default: html) | html |
--output | Single report destination; its extension must match --report-format | None |
--output-dir | Compatibility option: place the single report in this directory | None |
Exact local helpRun
vraven explain --help against your installed version before automating a release workflow.