El format .nbx és el contenidor universal de models de NeuroBrix: un arxiu ZIP que encapsula tot el que cal per executar un model d'IA en qualsevol maquinari compatible.
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.
| Principi | Descripció |
|---|---|
| Motor independent del model | El graf i els pesos viatgen al contenidor; el motor no necessita codi específic per a cada model |
| Autodescriptiu | Tot el que cal per executar-lo és dins del contenidor |
| Independent del maquinari | El mateix .nbx s'executa en tots els objectius de maquinari on el motor pot executar (vegeu Instal·lació segons el maquinari) |
| Orientat al transport | Dissenyat per a una distribució i una memòria cau eficients |
Conté la identitat del model, la classificació de la seva família i el tipus de generació (imatge, text, àudio, etc.).
Defineix el flux d'execució: com es connecten els components, les estructures de bucle (per als passos de difusió) i l'encaminament de dades.
El TensorDAG: un graf dirigit acíclic d'operacions de nivell ATen que defineix el càlcul matemàtic.
Pesos del model emmagatzemats en format safetensors, fragmentats en blocs d'uns 2 GB per a una transferència i un mapatge de memòria eficients.
En importar-los, els fitxers .nbx s'extreuen a ~/.neurobrix/cache/. L'entorn d'execució no llegeix mai directament els arxius .nbx: sempre treballa a partir de la memòria cau extreta.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
Els contenidors .nbx els produeix la cadena d'eines de construcció. Els descarregueu des del Centre de models; no cal que els construïu per utilitzar NeuroBrix.
neurobrix validate i neurobrix inspectSegüent: Arquitectura de l'entorn d'execució