neurobrix run gestisce ogni famiglia di modelli. Ciò che occorre passare dipende dalla famiglia.
| Modalità | Comandi | Ideale per |
|---|---|---|
| A caldo (consigliata) | neurobrix serve --model <name>, poi neurobrix run --prompt "..." |
Più esecuzioni, uso interattivo |
| A freddo | neurobrix run --model <name> --prompt "..." |
Esecuzioni singole, script |
Un'esecuzione a freddo carica i pesi, esegue e scarica. Mentre un daemon serve un altro modello, un'esecuzione a freddo viene rifiutata con Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.; eseguite invece contro il daemon a caldo. <name> qui sotto è il nome unico del modello, org/Model. Vedere la Guida al serving.
| Famiglia | Comando | Output |
|---|---|---|
| LLM | neurobrix run --model <name> --prompt "..." |
.txt |
| Immagine | neurobrix run --model <name> --prompt "..." --output x.png |
.png |
| Video | 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 |
testo; dove finisca senza --output: non ancora documentato |
| Upscaler | neurobrix upscale --model <name> --input in.png --output out.png |
.png |
| VLM | --prompt e --input-image, entrambi obbligatori |
testo |
| Audio LLM | --audio e --prompt, entrambi obbligatori |
testo |
| Multimodale | --prompt e --mode text, image o audio; la modalità è obbligatoria |
secondo la modalità |
Se manca un input obbligatorio, il motore si ferma con ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line. Un'estensione di --output errata viene rifiutata allo stesso modo, indicando quella attesa. Senza --output, il file si chiama output_<model> più l'estensione della famiglia (il testo di --help dice ancora output.png).
| Flag | Si applica a | Significato |
|---|---|---|
--prompt |
la maggior parte delle famiglie | Testo di input |
--steps, --cfg, --seed |
immagine, video | Passi di diffusione, scala di guidance, seed casuale |
--height, --width |
immagine | Dimensione dell'output |
--num-frames, --fps |
video | Lunghezza e frequenza della clip |
--input-image |
immagine, video, VLM, upscaler | Immagine di input; sull'immagine seleziona img2img, sul video i2v |
--mask-image |
immagine | Maschera di inpainting; richiede --input-image |
--video |
video | Clip di input, seleziona v2v |
--speaker |
TTS | Id della voce predefinita (--reference-audio non è collegato in questa versione: rifiutato per nome) |
--max-tokens, --temperature, --repetition-penalty, --top-k, --top-p |
LLM | Campionamento |
--system |
LLM | Prompt di sistema |
--chat / --no-chat |
LLM | Mutuamente esclusivi |
--mode |
tutte | auto, text, chat, agent, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
--set KEY=VALUE |
tutte | Sovrascrive un valore predefinito del modello; ripetibile |
--hardware |
tutte | Id del profilo hardware |
--explain-plan |
tutte | Mostra il piano di posizionamento |
--json |
tutte | Con --explain-plan: il piano come un unico record JSON |
I valori predefiniti di passi, guidance e dimensione provengono dal modello stesso. I valori predefiniti per famiglia dei flag di campionamento come la temperatura: non ancora documentati.
Immagine:
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
Risultato atteso: un PNG in robot.png.
Sovrascrivere un valore predefinito:
neurobrix run --prompt "test" --set global.guidance_scale=7.5
Passarne al massimo una su run o serve:
| Flag | Significato |
|---|---|
--compiled |
Il motore PyTorch; il predefinito dove PyTorch è installato |
--sequential |
Il motore PyTorch un'operazione alla volta, per il debug |
--triton |
Il motore Triton (nbxtensor, senza PyTorch); il predefinito dove PyTorch non è installato |
--triton-sequential |
Il motore Triton un'operazione alla volta, per il debug |
Più di uno produce Error: only one execution mode flag can be passed at a time e codice di uscita 1.
Successivo: Guida al serving
© 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Ü
Fonte della documentazione: GitHub