Skip to content
Docs
CLI and Automation
Headless rendering

Headless Rendering

tmorph render produces a static image of a Tensormorph view - a heatmap, a distribution plot, a framed Architecture view of a specific module - without an interactive session or a display attached, for embedding in reports, CI artifacts, or automated documentation rather than only ever being seen live in the app.

Basic usage

tmorph render checkpoints/model.safetensors \
  --view matrix-heatmap --select "model[\"layer.12.attn.q_proj\"]" \
  --out layer12-qproj.png

Any view addressable the same way it would be interactively - by address and view name - can be rendered this way, including a diff view against a second checkpoint, or a distribution plot.

Why this matters for automation

A validation failure or a flagged outlier is more actionable with a rendered image attached than with a bare pass/fail signal - CI Validation and batch inspection scripts commonly pair a diagnostic check with a headless render of the specific flagged region, so a reviewer can see the problem immediately rather than having to reopen the checkpoint interactively to reproduce it.

Related resources

  • Batch Inspection - rendering across many checkpoints as part of a batch report.
  • CI Validation - attaching a rendered image as evidence for a failed check.
  • Tensormorph CLI - the full tmorph command reference this command belongs to.