Begin hier:
neurobrix doctor
Het controleert het PATH, of de Triton-engine kan draaien (nbxtensor, Triton en een GPU-runtime), de PyTorch-build als die geïnstalleerd is, en de GPU's die het proces ziet, en toont de oplossing voor een blokkerend probleem. Exitcode 0 betekent dat er geen is gevonden, 1 dat er problemen zijn opgesomd.
neurobrix: command not foundDe scriptmap staat niet op PATH. Activeer uw omgeving (source nbx/bin/activate). Als de installatie slaagde maar de shell de opdracht nog steeds niet vindt, toont neurobrix doctor (uitgevoerd met het volledige pad, in de map bin/ van de omgeving) de exacte PATH-regel die u moet toevoegen.
externally-managed-environment (PEP 668)Uw distributie verbiedt een systeembrede pip install. Gebruik een virtuele omgeving:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
Installeer op Debian en Ubuntu eerst python3-venv. Of gebruik pipx install neurobrix.
Dit geldt alleen voor de PyTorch-engine; de Triton-engine heeft geen PyTorch nodig. doctor meldt dat er een GPU is en dat het geïnstalleerde PyTorch die niet kan gebruiken, en toont de oplossing, bijvoorbeeld:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
Welke build het toont, hangt af van de GPU (cu126 voor een V100; voor een nog niet gemeten architectuur verwijst het naar de selector van PyTorch). Meer in Installeren per hardware.
Wheels voor cu128, cu129, cu130 en cu132 bevatten sm_70 niet. doctor toont het verschil tussen de sm_XY van uw GPU en de architecturen waarvoor PyTorch is gebouwd. Installeer opnieuw:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix installeert geen PyTorch. pip install torch alleen haalt de CUDA-build op, zelfs op een machine zonder GPU. Voor de PyTorch-engine op een machine met alleen een CPU:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importEen import wordt geweigerd tenzij de vrije ruimte minstens ongeveer tweemaal de archiefgrootte plus 2 GiB is (het archief wordt naast de uitgepakte kopie bewaard). Maak eerst ruimte vrij. --no-keep verwijdert het archief na het uitpakken, wat vermindert wat er op schijf blijft. neurobrix clean --store verwijdert oude archieven en neurobrix clean --cache uitgepakte modellen.
Connection lost during download ... re-run the same command to resume
Voer dezelfde neurobrix import opnieuw uit. Het gedeeltelijke bestand (.part in ~/.neurobrix/store/) blijft bewaard en de download gaat verder waar hij stopte. Als de server niet kan hervatten, begint hij opnieuw bij nul.
| Status / code | Betekenis | Wat te doen |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Afgeschermd model, geen acceptatie verstuurd | Accepteer in de CLI of op het web: Licenties |
403 LICENSE_NOT_ACCEPTED |
Aangemeld, licentie niet geaccepteerd | Accepteer op de modelpagina |
403 MODEL_HIDDEN |
Het model is ingetrokken | Zoek de reden op de modelpagina |
403 GRANT_INVALID |
De downloadlink is verlopen (links gelden een uur) of is misvormd | Voer de import opnieuw uit voor een verse link |
| 404 | Slug niet gevonden | Controleer spelling en hoofdletters: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
De Hub kan dat bestand nu niet serveren | Probeer het later opnieuw; meld het als het aanhoudt |
Error: unknown category (exit 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Gebruik een van de vermelde waarden. ERROR: Cannot connect to registry is een ander, echt netwerkprobleem (exit 1).
a serving daemon is runningEr wordt een model geserveerd. Gebruik het (neurobrix run --prompt "..." zonder --model), of stop het:
neurobrix stop
neurobrix serve toont om dezelfde reden Error: a daemon is already running (PID n). Er draait maar één taak tegelijk.
Error: --model is required when no daemon is running.Geef --model <org>/<Model> op (de ene naam van het model, zoals import die neemt), of start een daemon met neurobrix serve. Een korte mapnaam wordt geweigerd, met de hubnaam die u moet gebruiken.
ZERO FALLBACK-meldingenDe engine weigert te gokken. De melding noemt wat ontbreekt:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Voeg de genoemde flag toe, of corrigeer de extensie van --output. Achtergrond: ZERO-principes.
Error: only one execution mode flag can be passed at a time — gebruik er maar één van --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — import heeft org/Model nodig.ERROR: Model '<org/name>' not found on registry. — controleer de naam in de catalogus.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean heeft er één nodig.sudo is dat die van root.| Code | Betekenis |
|---|---|
| 0 | Gelukt (doctor: geen blokkerend probleem) |
| 1 | Een fout (Error: ...; sommige meldingen van import: ERROR: ...), doctor vond problemen, of validate vond een ongeldig bestand |
| 2 | hub: het register wees het verzoek af, bijvoorbeeld een onbekende categorie |
| 130 | Onderbroken met Ctrl-C |
neurobrix run eindigt met de niet-nul-status van de run.
Voer neurobrix -v <command> uit voor de ontwikkelaarsregels van de engine (-vv voegt de traceback van een fout toe; NBX_LOG=debug in de omgeving doet beide) en meld het probleem met de uitvoer van neurobrix doctor --json.
CLI-referentie · Installeren 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Ü