O formato .nbx é o contentor universal de modelos do NeuroBrix — um arquivo ZIP que encapsula tudo o que é necessário para executar um modelo de IA em qualquer hardware suportado.
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.
| Princípio | Descrição |
|---|---|
| Motor independente do modelo | O grafo e os pesos viajam no contentor; o motor não precisa de código específico para cada modelo |
| Autodescritivo | Tudo o que é necessário para executar está dentro do contentor |
| Agnóstico ao hardware | O mesmo .nbx corre em todos os alvos de hardware em que o motor executa (veja Instalar por hardware) |
| Orientado ao transporte | Concebido para distribuição e cache eficientes |
Contém a identidade do modelo, a classificação da família e o tipo de geração (imagem, texto, áudio, etc.).
Define o fluxo de execução — como os componentes se ligam, as estruturas de ciclo (para os passos de difusão) e o encaminhamento de dados.
O TensorDAG — um grafo acíclico dirigido de operações ao nível do ATen que define o cálculo matemático.
Pesos do modelo guardados no formato safetensors, divididos em blocos de ~2GB para uma transferência e um mapeamento de memória eficientes.
Quando importados, os ficheiros .nbx são extraídos para ~/.neurobrix/cache/. O runtime nunca lê diretamente os arquivos .nbx — trabalha sempre a partir da cache extraída.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
Os contentores .nbx são produzidos pela cadeia de ferramentas de construção. Descarrega-os a partir do Hub de Modelos; não precisa de os construir para usar o NeuroBrix.
neurobrix validate e neurobrix inspectSeguinte: Arquitetura do Runtime