Empieza aquí:
neurobrix doctor
Comprueba el PATH, si el motor Triton puede ejecutarse (nbxtensor, Triton y un runtime de GPU), la versión de PyTorch si hay una instalada, y las GPU que ve el proceso, y muestra la corrección de un problema bloqueante. El código de salida 0 significa que no encontró ninguno, 1 que listó problemas.
neurobrix: command not foundEl directorio de scripts no está en PATH. Activa tu entorno (source nbx/bin/activate). Si la instalación funcionó pero el shell sigue sin encontrar el comando, neurobrix doctor (ejecutado por su ruta completa, en el directorio bin/ del entorno) imprime la línea exacta de PATH que hay que añadir.
externally-managed-environment (PEP 668)Tu distribución prohíbe pip install en todo el sistema. Usa un entorno virtual:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
En Debian y Ubuntu instala antes python3-venv. O usa pipx install neurobrix.
Esto solo afecta al motor PyTorch; el motor Triton no necesita PyTorch. doctor informa de que hay una GPU y de que el PyTorch instalado no puede usarla, y muestra la corrección, por ejemplo:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
La versión que muestra depende de la GPU (cu126 para una V100; para una arquitectura aún no medida remite al selector de PyTorch). Más en Instalar según el hardware.
Los wheels cu128, cu129, cu130 y cu132 no incluyen sm_70. doctor muestra la discrepancia entre el sm_XY de tu GPU y las arquitecturas para las que se compiló PyTorch. Reinstala:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix no instala PyTorch. pip install torch por sí solo descarga la versión CUDA incluso en una máquina sin GPU. Para el motor PyTorch en una máquina solo con CPU:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importUna importación se rechaza salvo que el espacio libre sea al menos el doble del tamaño del archivo más 2 GiB (el archivo se conserva junto a la copia extraída). Libera espacio primero. --no-keep borra el archivo tras la extracción, lo que reduce lo que permanece en disco. neurobrix clean --store elimina archivos antiguos y neurobrix clean --cache los modelos extraídos.
Connection lost during download ... re-run the same command to resume
Ejecuta de nuevo el mismo neurobrix import. El archivo parcial (.part en ~/.neurobrix/store/) se conserva y la descarga continúa desde donde se detuvo. Si el servidor no puede reanudar, reinicia desde cero.
| Estado / código | Significado | Qué hacer |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Modelo con acceso restringido, sin aceptación enviada | Acepta en la CLI o en la web: Licencias |
403 LICENSE_NOT_ACCEPTED |
Sesión iniciada, licencia no aceptada | Acepta en la página del modelo |
403 MODEL_HIDDEN |
El modelo fue retirado | Consulta el motivo en la página del modelo |
403 GRANT_INVALID |
El enlace de descarga caducó (los enlaces duran una hora) o está mal formado | Ejecuta de nuevo la importación para obtener un enlace nuevo |
| 404 | Slug no encontrado | Comprueba la ortografía y las mayúsculas: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
El hub no puede servir ese archivo ahora mismo | Reintenta más tarde; si persiste, infórmalo |
Error: unknown category (salida 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Usa uno de los valores listados. ERROR: Cannot connect to registry es un fallo de red distinto y real (salida 1).
a serving daemon is runningSe está sirviendo un modelo. Úsalo (neurobrix run --prompt "..." sin --model) o deténlo:
neurobrix stop
neurobrix serve muestra Error: a daemon is already running (PID n) por el mismo motivo. Solo se ejecuta una tarea a la vez.
Error: --model is required when no daemon is running.Pasa --model <org>/<Model> (el nombre único del modelo, tal como lo toma import), o inicia un daemon con neurobrix serve. Un nombre corto de directorio se rechaza, indicando el nombre del hub que hay que usar.
ZERO FALLBACKEl motor se niega a adivinar. El mensaje nombra lo que falta:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Añade la opción que nombra, o corrige la extensión de --output. Justificación: Principios ZERO.
Error: only one execution mode flag can be passed at a time — usa solo una de --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — import necesita org/Model.ERROR: Model '<org/name>' not found on registry. — comprueba el nombre en el catálogo.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean necesita una de ellas.sudo es el de root.| Código | Significado |
|---|---|
| 0 | Éxito (doctor: ningún problema bloqueante) |
| 1 | Un error (Error: ...; algunos mensajes de import: ERROR: ...), doctor encontró problemas, o validate encontró un archivo no válido |
| 2 | hub: el registro rechazó la petición, por ejemplo una categoría desconocida |
| 130 | Interrumpido con Ctrl-C |
neurobrix run sale con el estado distinto de cero de la ejecución.
Ejecuta neurobrix -v <command> para ver las líneas de desarrollo del motor (-vv añade el traceback de un error; NBX_LOG=debug en el entorno hace ambas cosas) e informa del problema con la salida de neurobrix doctor --json.
Referencia CLI · Instalar según el 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Ü