Iniziare da qui:
neurobrix doctor
Controlla il PATH, se il motore Triton può funzionare (nbxtensor, Triton e un runtime GPU), la build di PyTorch se installata, e le GPU che il processo vede, e stampa la correzione di un problema bloccante. Il codice di uscita 0 significa che non ne ha trovati, 1 che ha elencato dei problemi.
neurobrix: command not foundLa cartella degli script non è nel PATH. Attivare il proprio ambiente (source nbx/bin/activate). Se l'installazione è riuscita ma la shell non trova ancora il comando, neurobrix doctor (eseguito con il suo percorso completo, nella cartella bin/ dell'ambiente) stampa la riga PATH esatta da aggiungere.
externally-managed-environment (PEP 668)La vostra distribuzione vieta il pip install a livello di sistema. Usare un ambiente virtuale:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
Su Debian e Ubuntu installare prima python3-venv. Oppure usare pipx install neurobrix.
Riguarda solo il motore PyTorch; il motore Triton non richiede PyTorch. doctor segnala che è presente una GPU e che il PyTorch installato non può usarla, e stampa la correzione, per esempio:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
La build che stampa dipende dalla GPU (cu126 per una V100; per un'architettura non ancora misurata rimanda al selettore di PyTorch). Altro in Installazione per hardware.
Le wheel cu128, cu129, cu130 e cu132 non includono sm_70. doctor mostra la discrepanza tra l'sm_XY della vostra GPU e le architetture per cui PyTorch è stato compilato. Reinstallare:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix non installa PyTorch. pip install torch da solo scarica la build CUDA anche su una macchina senza GPU. Per il motore PyTorch su una macchina solo CPU:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importUn'importazione viene rifiutata a meno che lo spazio libero sia almeno circa il doppio della dimensione dell'archivio più 2 GiB (l'archivio viene conservato accanto alla copia estratta). Liberare prima dello spazio. --no-keep elimina l'archivio dopo l'estrazione, riducendo ciò che resta su disco. neurobrix clean --store rimuove i vecchi archivi e neurobrix clean --cache i modelli estratti.
Connection lost during download ... re-run the same command to resume
Eseguire di nuovo lo stesso neurobrix import. Il file parziale (.part in ~/.neurobrix/store/) viene conservato e il download prosegue da dove si era fermato. Se il server non può riprendere, ricomincia da zero.
| Stato / codice | Significato | Cosa fare |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Modello ad accesso controllato, nessuna accettazione inviata | Accettare nella CLI o sul web: Licenze |
403 LICENSE_NOT_ACCEPTED |
Accesso effettuato, licenza non accettata | Accettare nella pagina del modello |
403 MODEL_HIDDEN |
Il modello è stato ritirato | Consultare la pagina del modello per il motivo |
403 GRANT_INVALID |
Il link di download è scaduto (i link durano un'ora) o è malformato | Rieseguire l'importazione per ottenere un link nuovo |
| 404 | Slug non trovato | Controllare ortografia e maiuscole: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
L'hub non può servire quel file in questo momento | Riprovare più tardi; se persiste, segnalarlo |
Error: unknown category (uscita 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Usare uno dei valori elencati. ERROR: Cannot connect to registry è un caso diverso, un vero errore di rete (codice 1).
a serving daemon is runningUn modello è in fase di serving. Utilizzarlo (neurobrix run --prompt "..." senza --model), oppure fermarlo:
neurobrix stop
neurobrix serve stampa Error: a daemon is already running (PID n) per lo stesso motivo. Viene eseguita una sola attività alla volta.
Error: --model is required when no daemon is running.Passate --model <org>/<Model> (il nome unico del modello, come lo accetta import), oppure avviate un daemon con neurobrix serve. Un nome breve di directory viene rifiutato, indicando il nome dell'hub da usare.
ZERO FALLBACKIl motore rifiuta di indovinare. Il messaggio indica ciò che manca:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Aggiungere il flag indicato, oppure correggere l'estensione di --output. Motivazione: Principi ZERO.
Error: only one execution mode flag can be passed at a time — usate solo una tra --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — import richiede org/Model.ERROR: Model '<org/name>' not found on registry. — controllate il nome nel catalogo.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean ne richiede una.sudo è quella di root.| Codice | Significato |
|---|---|
| 0 | Successo (doctor: nessun problema bloccante) |
| 1 | Un errore (Error: ...; alcuni messaggi di import: ERROR: ...), doctor ha trovato problemi, oppure validate ha trovato un file non valido |
| 2 | hub: il registro ha rifiutato la richiesta, ad esempio una categoria sconosciuta |
| 130 | Interrotto con Ctrl-C |
neurobrix run esce con lo stato diverso da zero dell'esecuzione.
Eseguite neurobrix -v <command> per le righe di sviluppo del motore (-vv aggiunge il traceback di un errore; NBX_LOG=debug nell'ambiente fa entrambe le cose) e segnalate il problema con l'output di neurobrix doctor --json.
Riferimento CLI · Installazione per hardware
© 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Ü