El formato .nbx es el contenedor universal de modelos de NeuroBrix: un archivo ZIP que encapsula todo lo necesario para ejecutar un modelo de IA en cualquier hardware soportado.
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 | Descripción |
|---|---|
| Motor independiente del modelo | El grafo y los pesos viajan en el contenedor; el motor no necesita código específico de cada modelo |
| Autodescriptivo | Todo lo necesario para ejecutar está dentro del contenedor |
| Independiente del hardware | El mismo .nbx se ejecuta en todos los objetivos de hardware en los que se ejecuta el motor (consulta Instalar según el hardware) |
| Orientado al transporte | Diseñado para una distribución y un almacenamiento en caché eficientes |
Contiene la identidad del modelo, la clasificación de su familia y el tipo de generación (imagen, texto, audio, etc.).
Define el flujo de ejecución: cómo se conectan los componentes, las estructuras de bucle (para los pasos de difusión) y el enrutamiento de datos.
El TensorDAG: un grafo acíclico dirigido de operaciones a nivel ATen que define el cálculo matemático.
Pesos del modelo almacenados en formato safetensors, divididos en fragmentos de ~2GB para una transferencia y un mapeo en memoria eficientes.
Al importarse, los archivos .nbx se extraen en ~/.neurobrix/cache/. El motor de ejecución nunca lee directamente los archivos .nbx: siempre trabaja a partir de la caché extraída.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
Los contenedores .nbx los produce la cadena de herramientas de construcción. Los descargas desde el Hub de modelos; no necesitas construirlos para usar NeuroBrix.
neurobrix validate y neurobrix inspectSiguiente: Arquitectura del motor de ejecución