Comenceu aquí:
neurobrix doctor
Comprova el PATH, si el motor Triton pot funcionar (nbxtensor, Triton i un entorn d'execució de GPU), la versió de PyTorch si n'hi ha una d'instal·lada, i les GPU que veu el procés, i mostra la correcció d'un problema bloquejant. El codi de sortida 0 vol dir que no n'ha trobat cap, 1 que n'ha llistat.
neurobrix: command not foundEl directori dels scripts no és al PATH. Activeu el vostre entorn (source nbx/bin/activate). Si la instal·lació ha funcionat però l'intèrpret encara no troba l'ordre, neurobrix doctor (executat amb la seva ruta completa, al directori bin/ de l'entorn) imprimeix la línia exacta de PATH que cal afegir.
externally-managed-environment (PEP 668)La vostra distribució prohibeix el pip install a tot el sistema. Utilitzeu un entorn virtual:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
A Debian i Ubuntu instal·leu primer python3-venv. O utilitzeu pipx install neurobrix.
Això només afecta el motor PyTorch; el motor Triton no necessita PyTorch. doctor informa que hi ha una GPU i que el PyTorch instal·lat no la pot fer servir, i mostra la correcció, per exemple:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
La versió que mostra depèn de la GPU (cu126 per a una V100; per a una arquitectura encara no mesurada remet al selector de PyTorch). Més a Instal·lar segons el maquinari.
Les rodes cu128, cu129, cu130 i cu132 no inclouen sm_70. doctor mostra la discrepància entre el sm_XY de la vostra GPU i les arquitectures per a les quals s'ha compilat PyTorch. Reinstal·leu:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix no instal·la PyTorch. pip install torch tot sol baixa la versió CUDA fins i tot en una màquina sense GPU. Per al motor PyTorch en una màquina només amb CPU:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importUna importació es rebutja tret que l'espai lliure sigui almenys aproximadament el doble de la mida de l'arxiu més 2 GiB (l'arxiu es conserva al costat de la còpia extreta). Allibereu espai primer. --no-keep esborra l'arxiu després d'extreure'l, cosa que redueix el que es queda al disc. neurobrix clean --store elimina els arxius antics i neurobrix clean --cache els models extrets.
Connection lost during download ... re-run the same command to resume
Torneu a executar el mateix neurobrix import. El fitxer parcial (.part a ~/.neurobrix/store/) es conserva i la descàrrega continua des d'on s'havia aturat. Si el servidor no pot reprendre, es reinicia des de zero.
| Estat / codi | Significat | Què fer |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Model restringit, no s'ha enviat cap acceptació | Accepteu a la CLI o al web: Llicències |
403 LICENSE_NOT_ACCEPTED |
Sessió iniciada, llicència no acceptada | Accepteu a la pàgina del model |
403 MODEL_HIDDEN |
El model s'ha retirat | Consulteu la pàgina del model per veure'n el motiu |
403 GRANT_INVALID |
L'enllaç de descàrrega ha caducat (els enllaços duren una hora) o està mal format | Torneu a executar la importació per obtenir un enllaç nou |
| 404 | Identificador no trobat | Comproveu l'ortografia i les majúscules: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
El hub no pot servir aquest fitxer ara mateix | Torneu-ho a provar més tard; si persisteix, informeu-ne |
Error: unknown category (sortida 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Utilitzeu un dels valors llistats. ERROR: Cannot connect to registry és una fallada de xarxa real i diferent (sortida 1).
a serving daemon is runningS'està servint un model. O bé l'utilitzeu (neurobrix run --prompt "..." sense --model), o l'atureu:
neurobrix stop
neurobrix serve mostra Error: a daemon is already running (PID n) pel mateix motiu. Només s'executa una tasca alhora.
Error: --model is required when no daemon is running.Passeu --model <org>/<Model> (el nom únic del model, tal com el pren import), o inicieu un dimoni amb neurobrix serve. Un nom curt de directori es rebutja, indicant el nom del hub que cal fer servir.
ZERO FALLBACKEl motor es nega a endevinar. El missatge diu què falta:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Afegiu l'indicador que anomena, o corregiu l'extensió de --output. Justificació: Principis ZERO.
Error: only one execution mode flag can be passed at a time — feu servir només un de --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — import necessita org/Model.ERROR: Model '<org/name>' not found on registry. — comproveu el nom al catàleg.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean en necessita un.sudo és el de root.| Codi | Significat |
|---|---|
| 0 | Èxit (doctor: cap problema bloquejant) |
| 1 | Un error (Error: ...; alguns missatges d'import: ERROR: ...), doctor ha trobat problemes, o validate ha trobat un fitxer no vàlid |
| 2 | hub: el registre ha rebutjat la petició, per exemple una categoria desconeguda |
| 130 | Interromput amb Ctrl-C |
neurobrix run surt amb l'estat diferent de zero de l'execució.
Executeu neurobrix -v <command> per veure les línies de desenvolupament del motor (-vv hi afegeix el traceback d'un error; NBX_LOG=debug a l'entorn fa totes dues coses) i informeu del problema amb la sortida de neurobrix doctor --json.
Referència CLI · Instal·lació segons el maquinari
© 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Ü