Le format .nbx est le conteneur de modèles universel de NeuroBrix — une archive ZIP qui renferme tout ce qu'il faut pour exécuter un modèle d'IA sur n'importe quel matériel pris en charge.
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 | Description |
|---|---|
| Moteur indépendant du modèle | Le graphe et les poids voyagent dans le conteneur ; le moteur n'a besoin d'aucun code propre à un modèle |
| Auto-descriptif | Tout ce qu'il faut pour exécuter se trouve dans le conteneur |
| Indépendant du matériel | Le même .nbx s'exécute sur chaque cible matérielle prise en charge par le moteur (voir Installer selon le matériel) |
| Orienté transport | Conçu pour une distribution et une mise en cache efficaces |
Contient l'identité du modèle, la classification de sa famille et le type de génération (image, texte, audio, etc.).
Définit le flux d'exécution — la connexion des composants, les structures de boucle (pour les étapes de diffusion) et le routage des données.
Le TensorDAG — un graphe orienté acyclique d'opérations au niveau ATen qui définit le calcul mathématique.
Poids du modèle stockés au format safetensors, découpés en fragments d'environ 2 Go pour un transfert et un mappage mémoire efficaces.
À l'import, les fichiers .nbx sont extraits dans ~/.neurobrix/cache/. Le moteur d'exécution ne lit jamais directement les archives .nbx — il travaille toujours à partir du cache extrait.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
Les conteneurs .nbx sont produits par la chaîne d'outils de construction. Vous les téléchargez depuis le Hub de modèles ; vous n'avez pas besoin de les construire pour utiliser NeuroBrix.
neurobrix validate et neurobrix inspectSuivant : Architecture du moteur d'exécution