يتعامل neurobrix run مع كل عائلات النماذج. وما يجب أن تمرّره يعتمد على العائلة.
| الوضع | الأوامر | الأنسب لـ |
|---|---|---|
| دافئ (موصى به) | neurobrix serve --model <name>، ثم neurobrix run --prompt "..." |
عدة تشغيلات، والاستخدام التفاعلي |
| بارد | neurobrix run --model <name> --prompt "..." |
التشغيلات لمرة واحدة، والسكربتات |
يحمّل التشغيل البارد الأوزان وينفّذ ثم يفرّغها. وما دامت عملية خلفية تخدم نموذجًا آخر، يُرفض التشغيل البارد بالرسالة Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.؛ نفّذ عبر العملية الخلفية الدافئة بدلًا من ذلك. و<name> أدناه هو الاسم الوحيد للنموذج، org/Model. انظر دليل الخدمة.
| العائلة | الأمر | الناتج |
|---|---|---|
| LLM | neurobrix run --model <name> --prompt "..." |
.txt |
| صورة | neurobrix run --model <name> --prompt "..." --output x.png |
.png |
| فيديو | neurobrix run --model <name> --prompt "..." --output x.mp4 |
.mp4 |
| TTS | neurobrix run --model <name> --prompt "text" --output x.wav |
.wav |
| STT | neurobrix run --model <name> --audio f.wav |
نص؛ وأين يذهب دون --output: غير موثّق بعد |
| رفع الدقة | neurobrix upscale --model <name> --input in.png --output out.png |
.png |
| VLM | --prompt و--input-image، كلاهما مطلوب |
نص |
| Audio LLM | --audio و--prompt، كلاهما مطلوب |
نص |
| متعدد الوسائط | --prompt و--mode text أو image أو audio؛ والوضع مطلوب |
بحسب الوضع |
إذا غاب مُدخل مطلوب، يتوقف المحرك برسالة ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line. ويُرفض امتداد --output الخاطئ بالطريقة نفسها مع ذكر الامتداد المتوقع. ودون --output يُسمّى الملف output_<model> مضافًا إليه امتداد العائلة (ما زال نص --help يقول output.png).
| الخيار | ينطبق على | المعنى |
|---|---|---|
--prompt |
معظم العائلات | نص الإدخال |
--steps, --cfg, --seed |
صورة، فيديو | خطوات الانتشار، ومقياس التوجيه، وبذرة العشوائية |
--height, --width |
صورة | حجم الناتج |
--num-frames, --fps |
فيديو | طول المقطع ومعدله |
--input-image |
صورة، فيديو، VLM، رفع الدقة | صورة الإدخال؛ مع الصورة يختار img2img، ومع الفيديو i2v |
--mask-image |
صورة | قناع الترميم (inpainting)؛ يحتاج --input-image |
--video |
فيديو | مقطع الإدخال، يختار v2v |
--speaker |
TTS | معرّف صوت مُعدّ مسبقًا (--reference-audio غير موصول في هذا الإصدار: يُرفض باسمه) |
--max-tokens, --temperature, --repetition-penalty, --top-k, --top-p |
LLM | أخذ العينات |
--system |
LLM | موجّه النظام |
--chat / --no-chat |
LLM | متنافيان |
--mode |
الكل | auto, text, chat, agent, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
--set KEY=VALUE |
الكل | تجاوز قيمة افتراضية للنموذج؛ قابل للتكرار |
--hardware |
الكل | معرّف ملف تعريف العتاد |
--explain-plan |
الكل | عرض خطة التوزيع |
--json |
الكل | مع --explain-plan: الخطة في سجل JSON واحد |
تأتي القيم الافتراضية للخطوات والتوجيه والحجم من النموذج نفسه. أما القيم الافتراضية لكل عائلة لخيارات أخذ العينات مثل درجة الحرارة: فغير موثّقة بعد.
صورة:
neurobrix run --model <name> --prompt "A cute robot in a garden" --steps 20 --seed 42 --cfg 5.0 --width 1024 --height 1024 --output robot.png
النتيجة المتوقعة: ملف PNG في robot.png.
تجاوز قيمة افتراضية:
neurobrix run --prompt "test" --set global.guidance_scale=7.5
مرّر وضعًا واحدًا على الأكثر مع run أو serve:
| الخيار | المعنى |
|---|---|
--compiled |
محرك PyTorch؛ الافتراضي حيث يكون PyTorch مثبتًا |
--sequential |
محرك PyTorch عملية بعد عملية، لتصحيح الأخطاء |
--triton |
محرك Triton (nbxtensor، دون PyTorch)؛ الافتراضي حيث لا يكون PyTorch مثبتًا |
--triton-sequential |
محرك Triton عملية بعد عملية، لتصحيح الأخطاء |
تمرير أكثر من واحد يعطي Error: only one execution mode flag can be passed at a time ورمز الخروج 1.
التالي: دليل الخدمة
© 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Ü
مصدر التوثيق: GitLab