Comece aqui:
neurobrix doctor
Verifica o PATH, se o motor Triton pode correr (nbxtensor, Triton e um runtime de GPU), a versão do PyTorch, se estiver instalada, e as GPU que o processo vê, e mostra a correção de um problema bloqueante. O código de saída 0 significa que não encontrou nenhum, 1 que listou problemas.
neurobrix: command not foundO diretório de scripts não está no PATH. Ative o seu ambiente (source nbx/bin/activate). Se a instalação funcionou mas a shell continua sem encontrar o comando, o neurobrix doctor (executado pelo seu caminho completo, no diretório bin/ do ambiente) imprime a linha exata de PATH a acrescentar.
externally-managed-environment (PEP 668)A sua distribuição proíbe o pip install ao nível do sistema. Use um ambiente virtual:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
No Debian e no Ubuntu, instale primeiro o python3-venv. Ou use pipx install neurobrix.
Isto só diz respeito ao motor PyTorch; o motor Triton não precisa de PyTorch. O doctor indica que há uma GPU e que o PyTorch instalado não a pode usar, e mostra a correção, por exemplo:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
A versão que mostra depende da GPU (cu126 para uma V100; para uma arquitetura ainda não medida remete para o seletor do PyTorch). Mais em Instalar por hardware.
As wheels cu128, cu129, cu130 e cu132 não incluem sm_70. O doctor mostra a divergência entre o sm_XY da sua GPU e as arquiteturas para as quais o PyTorch foi construído. Reinstale:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix não instala o PyTorch. pip install torch sozinho traz a versão CUDA mesmo numa máquina sem GPU. Para o motor PyTorch numa máquina só com CPU:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importUma importação é recusada a menos que o espaço livre seja pelo menos cerca de o dobro do tamanho do arquivo mais 2 GiB (o arquivo é guardado ao lado da cópia extraída). Liberte primeiro espaço. O --no-keep apaga o arquivo depois da extração, o que reduz o que fica em disco. O neurobrix clean --store remove arquivos antigos e o neurobrix clean --cache os modelos extraídos.
Connection lost during download ... re-run the same command to resume
Execute de novo o mesmo neurobrix import. O ficheiro parcial (.part em ~/.neurobrix/store/) é mantido e a descarga continua de onde parou. Se o servidor não conseguir retomar, recomeça do zero.
| Estado / código | Significado | O que fazer |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Modelo com acesso restrito, sem aceitação enviada | Aceite na CLI ou na web: Licenças |
403 LICENSE_NOT_ACCEPTED |
Sessão iniciada, licença não aceite | Aceite na página do modelo |
403 MODEL_HIDDEN |
O modelo foi retirado | Consulte o motivo na página do modelo |
403 GRANT_INVALID |
A ligação de descarga expirou (as ligações duram uma hora) ou está malformada | Execute a importação de novo para obter uma ligação nova |
| 404 | Slug não encontrado | Verifique a grafia e as maiúsculas: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
O hub não consegue servir esse ficheiro neste momento | Tente mais tarde; se persistir, reporte |
Error: unknown category (saída 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Use um dos valores listados. ERROR: Cannot connect to registry é uma falha de rede diferente, real (saída 1).
a serving daemon is runningEstá a ser servido um modelo. Ou o usa (neurobrix run --prompt "..." sem --model), ou pára-o:
neurobrix stop
O neurobrix serve mostra Error: a daemon is already running (PID n) pela mesma razão. Só corre uma tarefa de cada vez.
Error: --model is required when no daemon is running.Passe --model <org>/<Model> (o nome único do modelo, tal como o import o recebe), ou arranque um daemon com neurobrix serve. Um nome curto de diretório é recusado, indicando o nome do hub a usar.
ZERO FALLBACKO motor recusa-se a adivinhar. A mensagem indica o 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'
Acrescente a opção que indica, ou corrija a extensão de --output. Justificação: princípios ZERO.
Error: only one execution mode flag can be passed at a time — use só uma de --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — o import precisa de org/Model.ERROR: Model '<org/name>' not found on registry. — verifique o nome no catálogo.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — o neurobrix clean precisa de uma delas.sudo é a do root.| Código | Significado |
|---|---|
| 0 | Sucesso (doctor: nenhum problema bloqueante) |
| 1 | Um erro (Error: ...; algumas mensagens do import: ERROR: ...), o doctor encontrou problemas, ou o validate encontrou um ficheiro inválido |
| 2 | hub: o registo rejeitou o pedido, por exemplo uma categoria desconhecida |
| 130 | Interrompido com Ctrl-C |
O neurobrix run sai com o estado diferente de zero da execução.
Execute neurobrix -v <command> para as linhas de desenvolvimento do motor (-vv acrescenta o traceback de um erro; NBX_LOG=debug no ambiente faz ambos) e comunique o problema com a saída de neurobrix doctor --json.
Referência da CLI · Instalar por 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Ü