Commencez ici :
neurobrix doctor
Il vérifie le PATH, si le moteur Triton peut tourner (nbxtensor, Triton et un runtime GPU), la version de PyTorch si elle est installée, et les GPU que le processus voit, et affiche la correction d'un problème bloquant. Le code de sortie 0 signifie qu'aucun n'a été trouvé, 1 que des problèmes ont été listés.
neurobrix: command not foundLe répertoire des scripts n'est pas dans le PATH. Activez votre environnement (source nbx/bin/activate). Si l'installation a réussi mais que le shell ne trouve toujours pas la commande, neurobrix doctor (lancé par son chemin complet, dans le répertoire bin/ de l'environnement) affiche la ligne PATH exacte à ajouter.
externally-managed-environment (PEP 668)Votre distribution interdit le pip install à l'échelle du système. Utilisez un environnement virtuel :
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
Sous Debian et Ubuntu, installez d'abord python3-venv. Ou utilisez pipx install neurobrix.
Cela ne concerne que le moteur PyTorch ; le moteur Triton n'a pas besoin de PyTorch. doctor signale qu'un GPU est présent et que le PyTorch installé ne peut pas l'utiliser, et affiche la correction, par exemple :
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
La version qu'il affiche dépend du GPU (cu126 pour une V100 ; pour une architecture pas encore mesurée, il renvoie au sélecteur de PyTorch). Plus de détails dans Installer selon le matériel.
Les wheels cu128, cu129, cu130 et cu132 n'incluent pas sm_70. doctor montre l'écart entre le sm_XY de votre GPU et les architectures pour lesquelles PyTorch a été construit. Réinstallez :
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix n'installe pas PyTorch. pip install torch seul tire la version CUDA même sur une machine sans GPU. Pour le moteur PyTorch sur une machine sans GPU :
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importUn import est refusé sauf si l'espace libre est d'au moins environ deux fois la taille de l'archive plus 2 GiB (l'archive est conservée à côté de la copie extraite). Libérez d'abord de la place. --no-keep supprime l'archive après l'extraction, ce qui réduit ce qui reste sur le disque. neurobrix clean --store supprime les anciennes archives et neurobrix clean --cache les modèles extraits.
Connection lost during download ... re-run the same command to resume
Relancez le même neurobrix import. Le fichier partiel (.part dans ~/.neurobrix/store/) est conservé et le téléchargement reprend là où il s'est arrêté. Si le serveur ne peut pas reprendre, il repart de zéro.
| Statut / code | Signification | Que faire |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Modèle à accès conditionné, aucune acceptation envoyée | Acceptez dans la CLI ou sur le web : Licences |
403 LICENSE_NOT_ACCEPTED |
Connecté, licence non acceptée | Acceptez sur la page du modèle |
403 MODEL_HIDDEN |
Le modèle a été retiré | Consultez la page du modèle pour en connaître la raison |
403 GRANT_INVALID |
Le lien de téléchargement a expiré (les liens durent une heure) ou est mal formé | Relancez l'import pour obtenir un lien neuf |
| 404 | Slug introuvable | Vérifiez l'orthographe et la casse : neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
Le hub ne peut pas servir ce fichier pour le moment | Réessayez plus tard ; si cela persiste, signalez-le |
Error: unknown category (code 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Utilisez l'une des valeurs listées. ERROR: Cannot connect to registry est une autre erreur, un véritable échec réseau (code de sortie 1).
a serving daemon is runningUn modèle est en cours de service. Utilisez-le (neurobrix run --prompt "..." sans --model), ou arrêtez-le :
neurobrix stop
neurobrix serve affiche Error: a daemon is already running (PID n) pour la même raison. Une seule tâche tourne à la fois.
Error: --model is required when no daemon is running.Passez --model <org>/<Model> (le nom unique du modèle, tel qu'import le prend), ou démarrez un démon avec neurobrix serve. Un nom court de répertoire est refusé, avec le nom du hub à utiliser.
ZERO FALLBACKLe moteur refuse de deviner. Le message nomme ce qui manque :
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Ajoutez le drapeau qu'il nomme, ou corrigez l'extension de --output. Justification : principes ZERO.
Error: only one execution mode flag can be passed at a time — n'utilisez qu'une seule option parmi --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — import nécessite org/Model.ERROR: Model '<org/name>' not found on registry. — vérifiez le nom dans le catalogue.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean a besoin de l'une d'elles.sudo, c'est celui de root.| Code | Signification |
|---|---|
| 0 | Succès (doctor : aucun problème bloquant) |
| 1 | Une erreur (Error: ... ; certains messages d'import : ERROR: ...), doctor a trouvé des problèmes, ou validate a trouvé un fichier non valide |
| 2 | hub : le registre a rejeté la requête, par exemple une catégorie inconnue |
| 130 | Interrompu avec Ctrl-C |
neurobrix run sort avec le statut non nul de l'exécution.
Lancez neurobrix -v <command> pour les lignes de développement du moteur (-vv ajoute le traceback d'une erreur ; NBX_LOG=debug dans l'environnement fait les deux) et signalez le problème avec la sortie de neurobrix doctor --json.
Référence CLI · Installer selon le matériel
© 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Ü