Формат .nbx — универсальный контейнер моделей NeuroBrix: ZIP-архив, в котором собрано всё необходимое для запуска модели ИИ на любом поддерживаемом оборудовании.
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.
| Принцип | Описание |
|---|---|
| Движок, не зависящий от модели | Граф и веса поставляются в контейнере; движку не нужен код под конкретную модель |
| Самоописываемость | Всё необходимое для запуска находится внутри контейнера |
| Независимость от оборудования | Один и тот же .nbx работает на любой аппаратной платформе, на которой выполняется движок (см. Установка по оборудованию) |
| Ориентация на передачу | Спроектирован для эффективного распространения и кэширования |
Содержит идентичность модели, классификацию семейства и тип генерации (изображение, текст, аудио и т. д.).
Определяет поток выполнения: как соединяются компоненты, структуры циклов (для шагов диффузии) и маршрутизацию данных.
TensorDAG — ориентированный ациклический граф операций уровня ATen, задающий математические вычисления.
Веса модели хранятся в формате safetensors и разбиты на фрагменты по ~2GB для эффективной передачи и отображения в память.
При импорте файлы .nbx распаковываются в ~/.neurobrix/cache/. Среда выполнения никогда не читает архивы .nbx напрямую — она всегда работает с распакованным кэшем.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
Контейнеры .nbx создаются инструментарием сборки. Вы скачиваете их из Хаба моделей; чтобы пользоваться NeuroBrix, собирать их самому не нужно.
neurobrix validate и neurobrix inspectДалее: Архитектура среды выполнения