Verificato su neurobrix 0.6.15 (il parser della riga di comando al tag v0.6.15, il cui riferimento generato è docs/reference/cli.md). Eseguite qualsiasi comando con --help per l'elenco di riferimento.
neurobrix --version # NeuroBrix v0.6.15
È richiesto un sottocomando. Comandi: run, serve, chat, stop, upscale, hub, import, list, remove, clean, info, inspect, validate, doctor.
I comandi di sviluppo calibrate, autotune, drift e coverage sono elencati da neurobrix --help -v, non da neurobrix --help. Ogni comando accetta -v (le righe di sviluppo del motore) e -vv (anche il traceback di un errore).
| Codice | Significato |
|---|---|
| 0 | Successo, --help e --version (doctor: nessun problema bloccante trovato; validate: tutti i file validi) |
| 1 | Un errore, stampato come Error: ... (alcuni messaggi di import: ERROR: ...); doctor: problemi trovati; validate: un file non è valido |
| 2 | Nessun sottocomando o un flag sconosciuto; hub: il registro ha rifiutato la richiesta (ad esempio una categoria sconosciuta) |
| 130 | Interrotto con Ctrl+C |
run esce con lo stato diverso da zero dell'esecuzione stessa.
--json (su info, inspect, list, remove, import, hub, doctor, validate, e su run con --explain-plan) stampa un record JSON su stdout e le righe leggibili su stderr. import --json emette un evento JSON per riga.
Un modello ha un solo nome, il suo nome sull'hub org/Model (sensibile alle maiuscole). import registra quel nome accanto al modello installato, e run, serve, upscale, inspect, remove e list lo usano; non esiste un secondo nome breve. Un modello installato prima della 0.6.3 mantiene il nome della sua directory finché neurobrix import org/Model non viene eseguito una volta per esso (non viene riscaricato nulla).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
Kokoro-82M parla inglese (lessico americano); scegliete una voce inglese, per esempio af_heart.
neurobrix hubSfogliare il registro (non serve l'accesso).
| Flag | Descrizione |
|---|---|
--category, -c |
Filtra per categoria (convertita in maiuscolo automaticamente) |
--search, -s |
Cerca per testo |
--registry |
URL del registry (predefinito https://neurobrix.org; le versioni precedenti alla 0.6.5 raggiungono https://neurobrix.es, ancora servito) |
--json |
Output leggibile da macchina |
neurobrix hub --category IMAGE
Una categoria sconosciuta stampa Error: unknown category '<value>' (valid categories: ...) (l'elenco viene dal registry) ed esce con 2. I valori validi sono in Hub dei modelli.
neurobrix import ORG/NAMEScaricare e installare un modello.
| Flag | Descrizione |
|---|---|
--registry |
URL del registro |
--force |
Reinstalla un modello già installato |
--no-keep |
Elimina il .nbx scaricato dopo l'estrazione (per impostazione predefinita lo conserva in ~/.neurobrix/store/) |
--container FILE.nbx |
Installa da un container che la macchina possiede già, verificato rispetto allo sha256 servito dall'hub; non viene scaricato nulla |
--accept-license |
Accetta una licenza ad accesso controllato senza prompt |
--json |
Un evento JSON per riga |
neurobrix import hexgrad/Kokoro-82M
Cosa succede, in ordine: il modello viene cercato (ERROR: Model 'org/name' not found on registry. se assente), la licenza viene controllata, il download viene richiesto e ricevuto in streaming, l'archivio viene controllato e poi estratto in ~/.neurobrix/cache/. L'ultima riga è Installed org/name · run: <command>.
<file>.nbx.part. Rieseguire lo stesso comando e riprende con una richiesta HTTP Range.ERROR: not enough disk for this import). Il picco di utilizzo è circa il doppio della dimensione dell'archivio, a meno di passare --no-keep.org/name is already installed (--force re-downloads). ed esce con 0, salvo con --force.Accept license terms? [yes/No]. In una shell non interattiva passare --accept-license o impostare NBX_ACCEPT_LICENSE=1, altrimenti: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (codice 1). L'accettazione viene ricordata localmente. Vedere Licenze.sha256sum) con lo sha256 dell'API. Un container indicato con --container viene verificato rispetto a quello sha256 prima di ogni altra cosa.| Comando | Descrizione |
|---|---|
neurobrix list [--store] [--json] |
Modelli installati, per nome (--store: anche gli archivi scaricati) |
neurobrix remove MODEL [--store] [--all] [--json] |
Rimuove un modello. Per impostazione predefinita rimuove solo la copia estratta; --store l'archivio, --all entrambi |
neurobrix clean [--store] [--cache] [--all] [-y] |
Svuota lo store e/o la cache. Senza nessuno dei tre flag: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (uscita 1) |
| Comando | Descrizione |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
Riepilogo di motore, modelli e hardware |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
Guarda dentro un file .nbx o un modello installato |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
Controlla uno o più file .nbx. Livelli (--level, -l): structure, schema, coherence (predefinito), deep. Uscita 0 se tutti i file sono validi, 1 altrimenti |
neurobrix doctor [--json] |
Controlla l'installazione: PATH, il motore Triton (versioni di nbxtensor e Triton), PyTorch e la sua build CUDA (facoltativo), le GPU che il processo vede |
doctor esce con 0 e "No blocking problem found", oppure con 1 e i problemi con la correzione di ciascuno (1 anche quando nessun motore può funzionare). PyTorch engine: not installed (optional; ...) è bloccante solo se nemmeno il motore Triton può funzionare; la wheel di PyTorch suggerita dipende dalla GPU (una V100 riceve cu126). Con --json stampa {"schema", "engine", "ok": bool, "problems": [...]}. Su Apple Silicon segnala la GPU Apple (Metal). Vedere Installazione per hardware.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
--model può essere omesso solo quando un daemon di serving è in esecuzione (Error: --model is required when no daemon is running.). Mentre un daemon serve un altro modello, un'esecuzione a freddo viene rifiutata (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.); con lo stesso modello, l'esecuzione usa il daemon a caldo.
Opzioni comuni
| Flag | Descrizione |
|---|---|
--hardware |
Profilo hardware (rilevato automaticamente se omesso) |
--explain-plan |
Stampa il piano di posizionamento, poi esce senza caricare nulla |
--json |
Con --explain-plan: il piano come un unico record JSON |
--prompt |
Prompt di testo |
--output |
File di output. Predefinito output_<model>.<ext>; l'estensione deve corrispondere alla famiglia del modello |
--seed, --set KEY=VALUE |
Seed; sovrascrive un valore predefinito del modello (ripetibile) |
--certified-only |
Equivale a NBX_AUTOTUNE_CERTIFIED_ONLY=1 (anche su calibrate e drift) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
Modalità di esecuzione (al massimo una; la predefinita è --compiled se PyTorch è installato, altrimenti --triton): --compiled, --sequential, --triton, --triton-sequential. Passarne più di una: Error: only one execution mode flag can be passed at a time (uscita 1).
Per famiglia
| Flag | Usato da |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
Modelli linguistici |
--turns FILE |
Modelli linguistici: un elenco JSON di messaggi dell'utente riprodotto come un'unica sessione di chat, turno dopo turno |
--steps, --cfg, --height, --width |
Generazione di immagini e video |
--input-image, --mask-image |
Immagine-a-immagine, inpainting, visione-linguaggio |
--num-frames, --fps, --input-video, --video |
Video |
--audio |
Riconoscimento vocale, modelli linguistici audio |
--speaker |
Sintesi vocale |
--reference-audio, --reference-image |
Non collegati in questa versione: rifiutati per nome |
Un primo comando per ogni famiglia
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
Gli input obbligatori dipendono dalla famiglia. Uno mancante ferma l'esecuzione con ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line., e un'estensione di output errata con ZERO FALLBACK: output extension '.x' incompatible with family .... I modelli visione-linguaggio richiedono --prompt e --input-image; i modelli linguistici audio richiedono --audio e --prompt; i modelli multimodali richiedono --mode text|image|audio.
Dove il riconoscimento vocale scriva la trascrizione quando --output è omesso non è ancora documentato.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| Flag | Descrizione |
|---|---|
--model |
Obbligatorio |
--input, --input-image |
Obbligatorio, l'immagine sorgente |
--output |
Obbligatorio, un percorso PNG |
--mode |
compiled (predefinito), sequential, triton, triton-sequential |
--hardware |
Profilo hardware |
Un input mancante stampa Error: input image not found: <path> (uscita 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| Comando | Flag |
|---|---|
serve |
--model (obbligatorio), --hardware, --timeout (secondi di inattività, predefinito 1800), --foreground, --http (serve anche l'API HTTP compatibile con OpenAI, predefinito 127.0.0.1:8765), --http-host, --http-port, --api-key-file (obbligatorio per un indirizzo diverso da loopback), --ready-fd / --ready-file (per un programma che avvia il daemon: dove scrivere il record JSON di una riga che segnala che è pronto), flag di modalità di esecuzione |
chat |
--max-tokens, --temperature, --repetition-penalty. In chat: /new, /context, /status, /quit |
stop |
nessuno; chiede al daemon di terminare, poi lo termina se necessario e ripulisce i file residui |
Se esiste già un daemon, serve stampa Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it ed esce con 1. Un'attività alla volta. Altro nella Guida al serving e in Serving and chat.
Successivo: Configurazione
© 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Ü