ابدأ من هنا:
neurobrix doctor
يفحص PATH، وما إذا كان محرك Triton قادرًا على العمل (nbxtensor وTriton وبيئة تشغيل للـ GPU)، وإصدار PyTorch إن كان مثبتًا، ووحدات GPU التي تراها العملية، ويطبع إصلاح أي مشكلة معيقة. رمز الخروج 0 يعني أنه لم يجد شيئًا، و1 يعني أنه سرد مشكلات.
neurobrix: command not foundمجلد السكربتات ليس في PATH. فعّل بيئتك (source nbx/bin/activate). وإذا نجح التثبيت لكن الطرفية ما زالت لا تجد الأمر، فإن neurobrix doctor (يُشغَّل بمساره الكامل، في مجلد bin/ الخاص بالبيئة) يطبع سطر PATH الدقيق الواجب إضافته.
externally-managed-environment (PEP 668)توزيعتك تمنع pip install على مستوى النظام. استخدم بيئة افتراضية:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
على Debian وUbuntu ثبّت python3-venv أولًا. أو استخدم pipx install neurobrix.
هذا يخص محرك PyTorch وحده؛ فمحرك Triton لا يحتاج إلى PyTorch. يبلّغ doctor بوجود GPU وبأن PyTorch المثبت لا يستطيع استخدامها، ويطبع الإصلاح، مثلًا:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
يعتمد الإصدار الذي يطبعه على الـ GPU (cu126 لبطاقة V100؛ ولمعمارية لم تُقس بعد يحيل إلى أداة الاختيار في PyTorch). المزيد في التثبيت بحسب العتاد.
عجلات cu128 وcu129 وcu130 وcu132 لا تتضمن sm_70. يُظهر doctor عدم التطابق بين sm_XY لوحدة GPU لديك والمعماريات التي بُني PyTorch لأجلها. أعد التثبيت:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
لا يثبّت pip install neurobrix مكتبة PyTorch. أما pip install torch وحده فيجلب إصدار CUDA حتى على جهاز بلا GPU. لمحرك PyTorch على جهاز بمعالج مركزي فقط:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importيُرفض الاستيراد ما لم تكن المساحة الحرة على الأقل نحو ضعف حجم الأرشيف زائد 2 GiB (يُحتفظ بالأرشيف إلى جانب النسخة المستخرجة). حرّر المساحة أولًا. يحذف --no-keep الأرشيف بعد الاستخراج، مما يقلل ما يبقى على القرص. ويزيل neurobrix clean --store الأرشيفات القديمة، وneurobrix clean --cache النماذج المستخرجة.
Connection lost during download ... re-run the same command to resume
شغّل neurobrix import نفسه مرة أخرى. يُحتفظ بالملف الجزئي (.part في ~/.neurobrix/store/) ويتابع التنزيل من حيث توقف. وإذا لم يستطع الخادم الاستئناف، يبدأ من الصفر.
| الحالة / الرمز | المعنى | ماذا تفعل |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
نموذج مقيّد، ولم يُرسَل قبول | اقبل في سطر الأوامر أو على الويب: التراخيص |
403 LICENSE_NOT_ACCEPTED |
مسجَّل الدخول، والترخيص غير مقبول | اقبل في صفحة النموذج |
403 MODEL_HIDDEN |
سُحب النموذج | راجع صفحة النموذج لمعرفة السبب |
403 GRANT_INVALID |
انتهت صلاحية رابط التنزيل (الروابط تدوم ساعة واحدة) أو هو مشوَّه | أعد الاستيراد للحصول على رابط جديد |
| 404 | المُعرِّف غير موجود | تحقق من الإملاء وحالة الأحرف: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
لا يستطيع الـ Hub تقديم ذلك الملف الآن | أعد المحاولة لاحقًا؛ وإذا استمر، أبلغ عنه |
Error: unknown category (رمز الخروج 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
استخدم إحدى القيم المدرجة. أما ERROR: Cannot connect to registry فهو فشل شبكة حقيقي ومختلف (الرمز 1).
a serving daemon is runningيُخدَّم نموذج حاليًا. إما أن تستخدمه (neurobrix run --prompt "..." دون --model)، أو توقفه:
neurobrix stop
يطبع neurobrix serve الرسالة Error: a daemon is already running (PID n) للسبب نفسه. لا تعمل إلا مهمة واحدة في كل مرة.
Error: --model is required when no daemon is running.مرّر --model <org>/<Model> (الاسم الوحيد للنموذج كما يأخذه import)، أو ابدأ عملية خلفية بالأمر neurobrix serve. ويُرفض اسم المجلد القصير مع ذكر اسم المركز الواجب استخدامه.
ZERO FALLBACKيرفض المحرك التخمين. تسمّي الرسالة ما هو مفقود:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
أضف الخيار الذي تسمّيه، أو صحّح امتداد --output. المبرر: مبادئ ZERO.
Error: only one execution mode flag can be passed at a time — استخدم واحدًا فقط من --compiled و--sequential و--triton و--triton-sequential.ERROR: Invalid model reference — يحتاج import إلى org/Model.ERROR: Model '<org/name>' not found on registry. — تحقق من الاسم في الكتالوج.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — يحتاج neurobrix clean إلى أحدها.sudo يكون هذا مجلد root.| الرمز | المعنى |
|---|---|
| 0 | نجاح (doctor: لا مشكلة مانعة) |
| 1 | خطأ (Error: ...؛ وبعض رسائل import: ERROR: ...)، أو وجد doctor مشكلات، أو وجد validate ملفًا غير صالح |
| 2 | hub: رفض السجل الطلب، مثلًا فئة غير معروفة |
| 130 | قوطع بـ Ctrl-C |
يخرج neurobrix run بالحالة غير الصفرية للتشغيل.
شغّل neurobrix -v <command> لرؤية أسطر المطوّر في المحرك (يضيف -vv تتبّع الاستدعاءات للخطأ؛ وNBX_LOG=debug في البيئة يفعل الأمرين)، وأبلغ عن المشكلة مرفقًا مخرجات neurobrix doctor --json.
مرجع سطر الأوامر · التثبيت حسب العتاد
© 2025–2026 Hocine Benkelaya. NeuroBrix engine released under the Apache License 2.0.
Developed by Hocine Benkelaya · Supported and funded by Neural Network Holding Ltd · Commercial distribution by WizWorks OÜ