Il formato .nbx è il container universale di modelli di NeuroBrix — un archivio ZIP che racchiude tutto ciò che serve per eseguire un modello AI su qualsiasi hardware supportato.
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.
| Principio | Descrizione |
|---|---|
| Motore indipendente dal modello | Il grafo e i pesi viaggiano nel container; il motore non richiede codice specifico per modello |
| Autodescrittivo | Tutto ciò che serve per l'esecuzione è dentro il container |
| Indipendente dall'hardware | Lo stesso .nbx gira su ogni target hardware su cui il motore esegue (vedere Installazione per hardware) |
| Orientato al trasporto | Progettato per una distribuzione e una cache efficienti |
Contiene l'identità del modello, la classificazione della famiglia e il tipo di generazione (immagine, testo, audio, ecc.).
Definisce il flusso di esecuzione: come si collegano i componenti, le strutture di ciclo (per i passi di diffusione) e l'instradamento dei dati.
Il TensorDAG: un grafo aciclico orientato di operazioni a livello ATen che definisce il calcolo matematico.
I pesi del modello, memorizzati in formato safetensors e suddivisi in blocchi da ~2GB per un trasferimento e un memory mapping efficienti.
All'importazione, i file .nbx vengono estratti in ~/.neurobrix/cache/. Il runtime non legge mai direttamente gli archivi .nbx: lavora sempre dalla cache estratta.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
I container .nbx sono prodotti dalla toolchain di build. Si scaricano dal Model Hub; non serve costruirli per usare NeuroBrix.
neurobrix validate e neurobrix inspectSuccessivo: Architettura Runtime