Beginne hier:
neurobrix doctor
Es prüft den PATH, ob die Triton-Engine laufen kann (nbxtensor, Triton und eine GPU-Laufzeit), den PyTorch-Build, falls einer installiert ist, und die GPUs, die der Prozess sieht, und gibt die Lösung für ein blockierendes Problem aus. Exit-Code 0 heißt, keines gefunden; 1 heißt, Probleme wurden aufgelistet.
neurobrix: command not foundDas Skriptverzeichnis liegt nicht im PATH. Aktiviere deine Umgebung (source nbx/bin/activate). Hat die Installation funktioniert, die Shell findet den Befehl aber trotzdem nicht, gibt neurobrix doctor (über den vollständigen Pfad im bin/-Verzeichnis der Umgebung aufgerufen) die genaue PATH-Zeile aus, die du hinzufügen musst.
externally-managed-environment (PEP 668)Deine Distribution verbietet ein systemweites pip install. Verwende eine virtuelle Umgebung:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
Installiere unter Debian und Ubuntu zuerst python3-venv. Oder verwende pipx install neurobrix.
Das betrifft nur die PyTorch-Engine; die Triton-Engine braucht kein PyTorch. doctor meldet, dass eine GPU vorhanden ist und das installierte PyTorch sie nicht nutzen kann, und gibt die Lösung aus, zum Beispiel:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
Welchen Build es ausgibt, hängt von der GPU ab (cu126 für eine V100; für eine noch nicht gemessene Architektur verweist es auf den Selektor von PyTorch). Mehr unter Installation nach Hardware.
Die Wheels cu128, cu129, cu130 und cu132 enthalten kein sm_70. doctor zeigt die Abweichung zwischen dem sm_XY deiner GPU und den Architekturen, für die PyTorch gebaut wurde. Neu installieren:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix installiert kein PyTorch. pip install torch allein zieht den CUDA-Build, selbst auf einem Rechner ohne GPU. Für die PyTorch-Engine auf einem reinen CPU-Rechner:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importEin Import wird abgelehnt, wenn der freie Platz nicht mindestens etwa das Doppelte der Archivgröße plus 2 GiB beträgt (das Archiv bleibt neben der entpackten Kopie liegen). Schaffe zuerst Platz. --no-keep löscht das Archiv nach dem Entpacken, was verringert, was auf der Festplatte bleibt. neurobrix clean --store entfernt alte Archive und neurobrix clean --cache entpackte Modelle.
Connection lost during download ... re-run the same command to resume
Führe dasselbe neurobrix import erneut aus. Die Teildatei (.part in ~/.neurobrix/store/) bleibt erhalten, und der Download läuft dort weiter, wo er aufgehört hat. Kann der Server nicht fortsetzen, beginnt er bei null von vorn.
| Status / Code | Bedeutung | Was zu tun ist |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Gesperrtes Modell, keine Zustimmung gesendet | In der CLI oder im Web akzeptieren: Lizenzen |
403 LICENSE_NOT_ACCEPTED |
Angemeldet, Lizenz nicht akzeptiert | Auf der Modellseite akzeptieren |
403 MODEL_HIDDEN |
Das Modell wurde zurückgezogen | Den Grund auf der Modellseite nachlesen |
403 GRANT_INVALID |
Der Download-Link ist abgelaufen (Links gelten eine Stunde) oder fehlerhaft | Den Import erneut ausführen, um einen frischen Link zu erhalten |
| 404 | Slug nicht gefunden | Schreibweise und Groß-/Kleinschreibung prüfen: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
Der Hub kann diese Datei gerade nicht ausliefern | Später erneut versuchen; bleibt es bestehen, melden |
Error: unknown category (Exit 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Verwende einen der aufgelisteten Werte. ERROR: Cannot connect to registry ist ein anderer, echter Netzwerkfehler (Exit 1).
a serving daemon is runningEin Modell wird bereitgestellt. Verwende es entweder (neurobrix run --prompt "..." ohne --model) oder beende es:
neurobrix stop
neurobrix serve gibt aus demselben Grund Error: a daemon is already running (PID n) aus. Es läuft immer nur eine Aufgabe.
Error: --model is required when no daemon is running.Gib --model <org>/<Model> an (den einen Namen des Modells, so wie import ihn nimmt), oder starte einen Daemon mit neurobrix serve. Ein kurzer Verzeichnisname wird abgelehnt, mit dem zu verwendenden Hub-Namen.
ZERO FALLBACK-MeldungenDie Engine weigert sich zu raten. Die Meldung nennt, was fehlt:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Füge das genannte Flag hinzu oder korrigiere die --output-Endung. Begründung: ZERO-Prinzipien.
Error: only one execution mode flag can be passed at a time — nutze nur eines von --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — import braucht org/Model.ERROR: Model '<org/name>' not found on registry. — prüfe den Namen im Katalog.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean braucht eines davon.sudo ist das das von root.| Code | Bedeutung |
|---|---|
| 0 | Erfolg (doctor: kein blockierendes Problem) |
| 1 | Ein Fehler (Error: ...; manche Meldungen von import: ERROR: ...), doctor hat Probleme gefunden, oder validate hat eine ungültige Datei gefunden |
| 2 | hub: Das Register hat die Anfrage abgelehnt, zum Beispiel wegen einer unbekannten Kategorie |
| 130 | Mit Strg-C unterbrochen |
neurobrix run endet mit dem von null verschiedenen Status des Laufs.
Führe neurobrix -v <command> für die Entwicklerzeilen der Engine aus (-vv fügt den Traceback eines Fehlers hinzu; NBX_LOG=debug in der Umgebung tut beides) und melde das Problem mit der Ausgabe von neurobrix doctor --json.
CLI-Referenz · Installation nach 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Ü