Buradan başlayın:
neurobrix doctor
PATH değişkenini, Triton motorunun çalışıp çalışamayacağını (nbxtensor, Triton ve bir GPU çalışma zamanı), kuruluysa PyTorch derlemesini ve sürecin gördüğü GPU'ları denetler; engelleyici bir sorunun düzeltmesini yazdırır. 0 çıkış kodu hiçbir sorun bulunmadığı, 1 sorunların listelendiği anlamına gelir.
neurobrix: command not foundBetik dizini PATH içinde değil. Ortamınızı etkinleştirin (source nbx/bin/activate). Kurulum çalıştıysa ama kabuk komutu hâlâ bulamıyorsa, neurobrix doctor (ortamın bin/ dizininde, tam yoluyla çalıştırılır) eklenecek tam PATH satırını yazdırır.
externally-managed-environment (PEP 668)Dağıtımınız sistem genelinde pip install komutunu yasaklıyor. Bir sanal ortam kullanın:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
Debian ve Ubuntu'da önce python3-venv kurun. Ya da pipx install neurobrix kullanın.
Bu yalnızca PyTorch motorunu ilgilendirir; Triton motorunun PyTorch'a ihtiyacı yoktur. doctor, bir GPU bulunduğunu ve kurulu PyTorch'un onu kullanamadığını bildirir ve düzeltmeyi yazdırır, örneğin:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
Yazdırdığı derleme GPU'ya bağlıdır (V100 için cu126; henüz ölçülmemiş bir mimari için PyTorch'un seçicisine yönlendirir). Ayrıntılar: Donanıma göre kurulum.
cu128, cu129, cu130 ve cu132 wheel'leri sm_70 içermez. doctor, GPU'nuzun sm_XY değeri ile PyTorch'un derlendiği mimariler arasındaki uyuşmazlığı gösterir. Yeniden kurun:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix PyTorch kurmaz. Tek başına pip install torch, GPU'su olmayan bir makinede bile CUDA derlemesini indirir. Yalnızca CPU'lu bir makinede PyTorch motoru için:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importBoş alan en az arşiv boyutunun yaklaşık iki katı artı 2 GiB değilse içe aktarma reddedilir (arşiv, açılmış kopyanın yanında tutulur). Önce yer açın. --no-keep, açma işleminden sonra arşivi siler; bu da diskte kalanı azaltır. neurobrix clean --store eski arşivleri, neurobrix clean --cache açılmış modelleri kaldırır.
Connection lost during download ... re-run the same command to resume
Aynı neurobrix import komutunu yeniden çalıştırın. Kısmi dosya (~/.neurobrix/store/ içindeki .part) saklanır ve indirme kaldığı yerden sürer. Sunucu devam ettiremiyorsa sıfırdan yeniden başlar.
| Durum / kod | Anlamı | Ne yapılmalı |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Kapılı model, kabul gönderilmedi | CLI'de ya da web'de kabul edin: Lisanslar |
403 LICENSE_NOT_ACCEPTED |
Oturum açık, lisans kabul edilmedi | Model sayfasında kabul edin |
403 MODEL_HIDDEN |
Model geri çekildi | Nedeni için model sayfasına bakın |
403 GRANT_INVALID |
İndirme bağlantısının süresi doldu (bağlantılar bir saat sürer) ya da bozuk | Yeni bir bağlantı için içe aktarmayı yeniden çalıştırın |
| 404 | Slug bulunamadı | Yazımı ve büyük/küçük harfi denetleyin: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
Hub şu anda o dosyayı sunamıyor | Daha sonra yeniden deneyin; sürerse bildirin |
Error: unknown category (çıkış 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Listelenen değerlerden birini kullanın. ERROR: Cannot connect to registry farklı, gerçek bir ağ hatasıdır (çıkış 1).
a serving daemon is runningBir model sunuluyor. Ya onu kullanın (--model olmadan neurobrix run --prompt "..."), ya da durdurun:
neurobrix stop
neurobrix serve aynı nedenle Error: a daemon is already running (PID n) yazdırır. Aynı anda yalnızca bir görev çalışır.
Error: --model is required when no daemon is running.--model <org>/<Model> verin (modelin tek adı, import komutunun aldığı biçimde) veya neurobrix serve ile bir daemon başlatın. Kısa bir dizin adı reddedilir ve kullanılacak hub adı belirtilir.
ZERO FALLBACK iletileriMotor tahmin yürütmeyi reddeder. İleti neyin eksik olduğunu adlandırır:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Adlandırdığı bayrağı ekleyin ya da --output uzantısını düzeltin. Gerekçe: ZERO ilkeleri.
Error: only one execution mode flag can be passed at a time — --compiled, --sequential, --triton, --triton-sequential arasından yalnızca birini kullanın.ERROR: Invalid model reference — import için org/Model gerekir.ERROR: Model '<org/name>' not found on registry. — adı katalogda kontrol edin.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean bunlardan birine ihtiyaç duyar.sudo altında bu root'unkidir.| Kod | Anlamı |
|---|---|
| 0 | Başarı (doctor: engelleyici sorun yok) |
| 1 | Bir hata (Error: ...; bazı import mesajları: ERROR: ...), doctor sorun buldu veya validate geçersiz bir dosya buldu |
| 2 | hub: kayıt defteri isteği reddetti, örneğin bilinmeyen bir kategori |
| 130 | Ctrl-C ile kesildi |
neurobrix run, çalıştırmanın sıfır olmayan durumuyla çıkar.
Motorun geliştirici satırları için neurobrix -v <command> çalıştırın (-vv bir hatanın traceback'ini ekler; ortamdaki NBX_LOG=debug ikisini birden yapar) ve sorunu neurobrix doctor --json çıktısıyla bildirin.
CLI başvurusu · Donanıma göre kurulum
© 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Ü