تنسيق .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 لنقل فعّال وتعيين ذاكرة (memory mapping) فعّال.
عند الاستيراد، تُستخرج ملفات .nbx إلى ~/.neurobrix/cache/. لا تقرأ بيئة التشغيل أرشيفات .nbx مباشرة أبدًا — بل تعمل دائمًا من الذاكرة المؤقتة المستخرجة.
~/.neurobrix/
├── store/ # Downloaded .nbx archives
└── cache/ # Extracted model files (runtime reads from here)
تُنتَج حاويات .nbx بواسطة سلسلة أدوات البناء. أنت تنزّلها من مركز النماذج؛ ولا تحتاج إلى بنائها لاستخدام NeuroBrix.
neurobrix validate وneurobrix inspectالتالي: بنية بيئة التشغيل