Het .nbx-formaat is de universele modelcontainer van NeuroBrix — een ZIP-archief dat alles bevat wat nodig is om een AI-model uit te voeren op elke ondersteunde hardware.
model.nbx
├── manifest.json # Model identity, family, generation type
├── topology.json # Execution flow, component connections, loops
├── runtime/
│ ├── defaults.json # User-tunable defaults (steps, guidance, temperature)
│ └── variables.json # Variable resolution contracts
├── components/<name>/
│ ├── graph.json # TensorDAG of ATen operations
│ ├── runtime.json # Component runtime config
│ ├── profile.json # Hardware profile hints
│ ├── config.json # Component configuration
│ ├── weights_index.json # Weight shard mapping
│ └── weights/
│ ├── shard_000.safetensors
│ └── shard_001.safetensors
└── modules/ # Scheduler, tokenizer, etc.
| Principe | Beschrijving |
|---|---|
| Modelonafhankelijke engine | De graaf en de gewichten reizen mee in de container; de engine heeft geen modelspecifieke code nodig |
| Zelfbeschrijvend | Alles wat nodig is om uit te voeren zit in de container |
| Hardwareonafhankelijk | Dezelfde .nbx draait op elk hardwaredoel waarop de engine uitvoert (zie Installeren per hardware) |
| Transportgericht | Ontworpen voor efficiënte distributie en caching |
Bevat de identiteit van het model, de familieclassificatie en het generatietype (beeld, tekst, audio, enz.).
Definieert de uitvoeringsstroom — hoe componenten zijn verbonden, lusstructuren (voor diffusiestappen) en gegevensroutering.
De TensorDAG — een gerichte acyclische graaf van bewerkingen op ATen-niveau die de wiskundige berekening vastlegt.
Modelgewichten opgeslagen in safetensors-formaat, opgedeeld in brokken van ~2GB voor efficiënte overdracht en geheugentoewijzing (memory mapping).
Bij het importeren worden .nbx-bestanden uitgepakt naar ~/.neurobrix/cache/. De runtime leest .nbx-archieven nooit rechtstreeks — hij werkt altijd vanuit de uitgepakte cache.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
De .nbx-containers worden geproduceerd door de bouwtoolchain. U downloadt ze van de Model Hub; u hoeft ze niet zelf te bouwen om NeuroBrix te gebruiken.
neurobrix validate en neurobrix inspectVolgende: Runtime-architectuur