تم التحقق مقابل neurobrix 0.6.15 (محلل سطر الأوامر عند الوسم v0.6.15، ومرجعه المولَّد هو docs/reference/cli.md). شغّل أي أمر مع --help للحصول على القائمة المعتمدة.
neurobrix --version # NeuroBrix v0.6.15
الأمر الفرعي مطلوب. الأوامر: run وserve وchat وstop وupscale وhub وimport وlist وremove وclean وinfo وinspect وvalidate وdoctor.
أوامر المطوّرين calibrate وautotune وdrift وcoverage يسردها neurobrix --help -v وليس neurobrix --help. ويقبل كل أمر -v (أسطر المطوّر في المحرك) و-vv (ومعها تتبّع الاستدعاءات للخطأ).
| الرمز | المعنى |
|---|---|
| 0 | نجاح، و--help و--version (doctor: لم يُعثر على مشكلة معيقة؛ validate: كل الملفات صالحة) |
| 1 | خطأ يُطبع بالصيغة Error: ... (بعض رسائل import: ERROR: ...)؛ doctor: وُجدت مشكلات؛ validate: ملف غير صالح |
| 2 | لا أمر فرعي أو خيار غير معروف؛ hub: رفض السجل الطلب (مثلًا فئة غير معروفة) |
| 130 | قوطع بـ Ctrl+C |
يخرج run بالحالة غير الصفرية للتشغيل نفسه.
يطبع --json (في info وinspect وlist وremove وimport وhub وdoctor وvalidate، وفي run مع --explain-plan) سجل JSON واحدًا على stdout والأسطر المقروءة على stderr. ويُصدر import --json حدث JSON واحدًا في كل سطر.
للنموذج اسم واحد هو اسمه على المركز org/Model (مع مراعاة حالة الأحرف). يسجّل import هذا الاسم بجوار النموذج المثبت، وتستخدمه run وserve وupscale وinspect وremove وlist؛ ولا يوجد اسم ثانٍ قصير. والنموذج المثبت قبل 0.6.3 يحتفظ باسم مجلده إلى أن يُشغَّل له neurobrix import org/Model مرة واحدة (دون إعادة تنزيل أي شيء).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
يتحدث Kokoro-82M الإنجليزية (معجم أمريكي)؛ اختر صوتًا إنجليزيًا مثل af_heart.
neurobrix hubتصفح السجل (لا حاجة إلى تسجيل دخول).
| الخيار | الوصف |
|---|---|
--category, -c |
التصفية بحسب الفئة (تُحوَّل إلى أحرف كبيرة نيابةً عنك) |
--search, -s |
البحث بالنص |
--registry |
عنوان URL للسجل (الافتراضي https://neurobrix.org؛ والإصدارات السابقة لـ 0.6.5 تتصل بـ https://neurobrix.es، وما زال مخدومًا) |
--json |
إخراج مقروء آليًا |
neurobrix hub --category IMAGE
تطبع الفئة غير المعروفة Error: unknown category '<value>' (valid categories: ...) (القائمة تأتي من السجل) وتخرج بالرمز 2. القيم الصالحة موجودة في مركز النماذج.
neurobrix import ORG/NAMEتنزيل نموذج وتثبيته.
| الخيار | الوصف |
|---|---|
--registry |
عنوان السجل |
--force |
إعادة تثبيت نموذج مثبَّت بالفعل |
--no-keep |
حذف ملف .nbx المنزَّل بعد الاستخراج (يحتفظ به الافتراضي في ~/.neurobrix/store/) |
--container FILE.nbx |
يثبّت من حاوية موجودة على الجهاز، بعد التحقق منها مقابل قيمة sha256 التي يقدّمها المركز؛ ولا يُنزَّل شيء |
--accept-license |
قبول ترخيص مقيّد دون سؤال |
--json |
حدث JSON واحد في كل سطر |
neurobrix import hexgrad/Kokoro-82M
ما يحدث بالترتيب: يُبحث عن النموذج (ERROR: Model 'org/name' not found on registry. إن لم يوجد)، ثم يُتحقق من الترخيص، ثم يُطلب التنزيل ويُستقبل تدفقًا، ثم يُفحص الأرشيف، ثم يُستخرج إلى ~/.neurobrix/cache/. والسطر الأخير هو Installed org/name · run: <command>.
<file>.nbx.part. أعد تشغيل الأمر نفسه فيُستأنف بطلب HTTP من نوع Range.ERROR: not enough disk for this import). والذروة في الاستخدام نحو ضعف حجم الأرشيف ما لم تمرّر --no-keep.org/name is already installed (--force re-downloads). ويخرج بالرمز 0 ما لم يُمرَّر --force.Accept license terms? [yes/No]. في طرفية غير تفاعلية مرّر --accept-license أو اضبط NBX_ACCEPT_LICENSE=1، وإلا: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (الرمز 1). يُتذكَّر القبول محليًا. انظر التراخيص.sha256sum) بقيمة sha256 في API. أما الحاوية المُمرَّرة عبر --container فيُتحقق منها مقابل هذه القيمة قبل أي شيء آخر.| الأمر | الوصف |
|---|---|
neurobrix list [--store] [--json] |
النماذج المثبتة بأسمائها (--store: والأرشيفات المنزّلة أيضًا) |
neurobrix remove MODEL [--store] [--all] [--json] |
إزالة نموذج. الافتراضي يزيل النسخة المستخرجة فقط؛ و--store الأرشيف، و--all كليهما |
neurobrix clean [--store] [--cache] [--all] [-y] |
يُفرغ المخزن و/أو الذاكرة المؤقتة. ومن دون أي من الأعلام الثلاثة: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (رمز الخروج 1) |
| الأمر | الوصف |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
ملخص المحرك والنماذج والعتاد |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
النظر داخل ملف .nbx أو نموذج مثبَّت |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
يفحص ملف .nbx واحدًا أو أكثر. المستويات (--level، -l): structure، schema، coherence (الافتراضي)، deep. يخرج بالرمز 0 إذا كانت كل الملفات صالحة، وإلا 1 |
neurobrix doctor [--json] |
يفحص التثبيت: PATH، ومحرك Triton (إصدارا nbxtensor وTriton)، وPyTorch وإصدار CUDA الخاص به (اختياري)، ووحدات GPU التي تراها العملية |
يخرج doctor بالرمز 0 مع "No blocking problem found"، أو بالرمز 1 مع المشكلات وإصلاح كل منها (و1 أيضًا حين لا يستطيع أي محرك العمل). ولا يكون PyTorch engine: not installed (optional; ...) مشكلة معيقة إلا إذا عجز محرك Triton أيضًا عن العمل؛ وحزمة PyTorch التي يقترحها تعتمد على الـ GPU (بطاقة V100 تحصل على cu126). ومع --json يطبع {"schema", "engine", "ok": bool, "problems": [...]}. وعلى Apple Silicon يبلّغ عن GPU من Apple (Metal). انظر التثبيت بحسب العتاد.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
لا يجوز حذف --model إلا عندما تعمل عملية خدمة خلفية (Error: --model is required when no daemon is running.). وما دامت عملية خلفية تخدم نموذجًا آخر، يُرفض التشغيل البارد (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.)؛ ومع النموذج نفسه يستخدم التشغيل العملية الخلفية الدافئة.
الخيارات الشائعة
| الخيار | الوصف |
|---|---|
--hardware |
ملف تعريف العتاد (يُكتشف تلقائيًا إن حُذف) |
--explain-plan |
يطبع خطة التوزيع ثم يخرج دون تحميل أي شيء |
--json |
مع --explain-plan: الخطة في سجل JSON واحد |
--prompt |
نص الموجّه |
--output |
ملف الإخراج. الافتراضي output_<model>.<ext>؛ ويجب أن يطابق الامتداد عائلة النموذج |
--seed, --set KEY=VALUE |
البذرة؛ وتجاوز قيمة افتراضية للنموذج (قابل للتكرار) |
--certified-only |
مثل NBX_AUTOTUNE_CERTIFIED_ONLY=1 (وأيضًا في calibrate وdrift) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
وضع التنفيذ (واحد على الأكثر؛ والافتراضي --compiled إذا كان PyTorch مثبتًا، وإلا --triton): --compiled و--sequential و--triton و--triton-sequential. تمرير أكثر من واحد: Error: only one execution mode flag can be passed at a time (رمز الخروج 1).
بحسب العائلة
| الخيار | يستخدمه |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
نماذج اللغة |
--turns FILE |
النماذج اللغوية: قائمة JSON برسائل المستخدم تُشغَّل بوصفها جلسة محادثة واحدة، دورًا بعد دور |
--steps, --cfg, --height, --width |
توليد الصور والفيديو |
--input-image، --mask-image |
من صورة إلى صورة، والإكمال الداخلي، والرؤية واللغة |
--num-frames, --fps, --input-video, --video |
الفيديو |
--audio |
تحويل الكلام إلى نص، ونماذج اللغة الصوتية |
--speaker |
تحويل النص إلى كلام |
--reference-audio، --reference-image |
غير موصولين في هذا الإصدار: يُرفضان باسميهما |
أمر أول لكل عائلة
neurobrix run --model <llm> --prompt "Explain ZFS in one paragraph" --max-tokens 256
neurobrix run --model <image> --prompt "a lighthouse at dusk" --steps 30 --output out.png
neurobrix run --model <video> --prompt "waves on a beach" --num-frames 33 --output out.mp4
neurobrix run --model <tts> --prompt "Hello" --speaker <voice> --output hello.wav
neurobrix run --model <stt> --audio speech.wav
neurobrix run --model <vlm> --prompt "Describe this" --input-image photo.png
تعتمد المُدخلات المطلوبة على العائلة. المُدخل المفقود يوقف التشغيل برسالة ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line.، وامتداد الإخراج الخاطئ برسالة ZERO FALLBACK: output extension '.x' incompatible with family .... تحتاج نماذج الرؤية واللغة إلى --prompt و--input-image؛ وتحتاج نماذج اللغة الصوتية إلى --audio و--prompt؛ وتحتاج النماذج متعددة الوسائط إلى --mode text|image|audio.
أين يكتب تحويل الكلام إلى نص النص المُفرَّغ عندما يُحذف --output: غير موثّق بعد.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| الخيار | الوصف |
|---|---|
--model |
مطلوب |
--input, --input-image |
مطلوب، الصورة المصدر |
--output |
مطلوب، مسار PNG |
--mode |
compiled (الافتراضي) وsequential وtriton وtriton-sequential |
--hardware |
ملف تعريف العتاد |
يطبع الإدخال المفقود Error: input image not found: <path> (رمز الخروج 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| الأمر | الخيارات |
|---|---|
serve |
--model (مطلوب)، --hardware، --timeout (ثواني الخمول، الافتراضي 1800)، --foreground، --http (يخدم أيضًا واجهة HTTP المتوافقة مع OpenAI، افتراضيًا 127.0.0.1:8765)، --http-host، --http-port، --api-key-file (مطلوب لأي عنوان غير loopback)، --ready-fd / --ready-file (لبرنامج يُطلق العملية الخلفية: حيث يُكتب سجل الجاهزية بصيغة JSON في سطر واحد)، وأعلام وضع التنفيذ |
chat |
--max-tokens و--temperature و--repetition-penalty. داخل المحادثة: /new و/context و/status و/quit |
stop |
لا شيء؛ يطلب من العملية الخلفية الخروج، ثم ينهيها إن لزم، وينظّف الملفات المتبقية |
إذا كانت هناك عملية خلفية بالفعل، يطبع serve الرسالة Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it ويخرج بالرمز 1. مهمة واحدة في كل مرة. المزيد في دليل الخدمة وفي Serving and chat.
التالي: الإعدادات
© 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Ü