Skip to research
Vraelis Research
All researchVraelis Prompto / Reference note and proposed protocol

Model files with external data

Treat external tensor data as part of the model’s dependency boundary.

Research note · November 14, 2026

Research question

Can a model file remain unchanged while a referenced tensor file changes?

Method

  1. Prepare an ONNX fixture that stores tensor content externally. Record both the model file and every external object required to load it, including the location and any offset or length information.
  2. Change only the external tensor file and compare a model-only manifest with a complete dependency manifest. The experiment should reveal which boundary each manifest actually covers.
  3. Test missing, relocated and unexpectedly large external files. Resolve paths within a declared root and report unresolved dependencies rather than calling a partial scan complete.

Records to retain

  • ONNX model and external data references
  • Resolved dependency paths
  • Digests and lengths for each object
  • Load failures and unresolved references

Source basis

The ONNX representation supports tensors whose data is stored outside the model protobuf. A digest of the model file alone therefore does not necessarily identify all bytes consumed during loading.

Interpretation & limits

Dependency discovery is format-specific. Finding external tensor references does not cover arbitrary custom operators or application-side preprocessing. This note does not claim complete dependency discovery in Prompto.

Next experiments

  • Add external-data cases to a bounded fixture suite.
  • Compare declared dependencies with the files opened by a controlled loader.

References

  1. ONNX intermediate representation
  2. Naming Things with Hashes

Technical reference

Implementation details supporting this note, drawn directly from the maintained documentation. These are technical references, not additional papers or new experimental results. Expand a topic to inspect its method, fields and limits.

Related notes