NeuronScope
Interactive diagramBetasince v0.7.0

Experiment flow

Walk through building, recording, and persisting a single experiment — from the builder call site to the final .nsz artifact.

Audience: Users, contributorsRead: 5 minEdit on GitHub

The dashed edges are optional paths. The profiler is only wired in when the user opts into overhead measurement; the artifact is written whether or not profiling ran.

The pipeline

Interactive pipelinehover · focus · click
EntryBuilderStageResolve inputsCoreRecorderStageProfilerStageCollateOutput.nsz
Entry
Builder

Fluent API that assembles model, dataset, prompt, and probe references into an unresolved plan.

Open reference →
The recorder and profiler observe the same iteration; they do not double-step the dataset.

Interpretation notes

  • The recorder never mutates the model. All state lives in the ring buffer until collation.
  • Collation is the only stage that can fail on a size budget — it holds the manifest and the last frame of each probe.
  • The write stage is atomic: a partial .nsz file is never observable to a reader.
Related