Начните отсюда:
neurobrix doctor
Проверяет PATH, может ли работать движок Triton (nbxtensor, Triton и среда выполнения GPU), сборку PyTorch, если она установлена, и GPU, которые видит процесс, и выводит исправление блокирующей проблемы. Код выхода 0 означает, что проблем нет, 1 — что проблемы перечислены.
neurobrix: command not foundКаталога со скриптами нет в PATH. Активируйте окружение (source nbx/bin/activate). Если установка прошла, но оболочка по-прежнему не находит команду, neurobrix doctor (запущенный по полному пути, из каталога bin/ окружения) выводит точную строку PATH, которую нужно добавить.
externally-managed-environment (PEP 668)Ваш дистрибутив запрещает общесистемный pip install. Используйте виртуальное окружение:
python3 -m venv nbx && source nbx/bin/activate
pip install neurobrix
В Debian и Ubuntu сначала установите python3-venv. Либо используйте pipx install neurobrix.
Это касается только движка PyTorch; движку Triton PyTorch не нужен. doctor сообщает, что GPU есть, а установленный PyTorch не может его использовать, и выводит исправление, например:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu124
Предлагаемая сборка зависит от GPU (cu126 для V100; для ещё не измеренной архитектуры он отсылает к селектору PyTorch). Подробнее в разделе Установка по оборудованию.
Колёса cu128, cu129, cu130 и cu132 не включают sm_70. doctor показывает расхождение между sm_XY вашего GPU и архитектурами, для которых собран PyTorch. Переустановите:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cu126
pip install neurobrix не устанавливает PyTorch. pip install torch сам по себе тянет CUDA-сборку даже на машине без GPU. Для движка PyTorch на машине только с CPU:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "neurobrix[pytorch]"
ERROR: not enough disk for this importИмпорт отклоняется, если свободного места меньше примерно удвоенного размера архива плюс 2 GiB (архив хранится рядом с распакованной копией). Сначала освободите место. --no-keep удаляет архив после распаковки, что уменьшает занятое на диске место. neurobrix clean --store удаляет старые архивы, а neurobrix clean --cache — распакованные модели.
Connection lost during download ... re-run the same command to resume
Запустите тот же neurobrix import снова. Частичный файл (.part в ~/.neurobrix/store/) сохраняется, и загрузка продолжается с того места, где остановилась. Если сервер не может возобновить передачу, она начинается заново.
| Статус / код | Значение | Что делать |
|---|---|---|
401 LICENSE_LOGIN_REQUIRED |
Закрытая модель, согласие не отправлено | Примите условия в CLI или в вебе: Лицензии |
403 LICENSE_NOT_ACCEPTED |
Вход выполнен, лицензия не принята | Примите условия на странице модели |
403 MODEL_HIDDEN |
Модель была изъята | Причину смотрите на странице модели |
403 GRANT_INVALID |
Ссылка для загрузки истекла (ссылки действуют один час) или искажена | Повторите импорт, чтобы получить новую ссылку |
| 404 | Slug не найден | Проверьте написание и регистр: neurobrix hub --search <name> |
503 ARTIFACT_UNAVAILABLE / ARTIFACT_CHANGED |
Хаб сейчас не может отдать этот файл | Повторите позже; если не проходит, сообщите об этом |
Error: unknown category (выход 2)Error: unknown category 'AUDIO' (valid categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO)
Используйте одно из перечисленных значений. ERROR: Cannot connect to registry — это другая, настоящая сетевая ошибка (код 1).
a serving daemon is runningМодель уже обслуживается. Либо используйте её (neurobrix run --prompt "..." без --model), либо остановите её:
neurobrix stop
neurobrix serve по той же причине выводит Error: a daemon is already running (PID n). Одновременно выполняется только одна задача.
Error: --model is required when no daemon is running.Передайте --model <org>/<Model> (единственное имя модели, как его принимает import) или запустите демон командой neurobrix serve. Короткое имя каталога отклоняется с указанием имени на хабе.
ZERO FALLBACKДвижок отказывается гадать. В сообщении названо, чего не хватает:
ZERO FALLBACK: family 'upscaler' requires --input-image. Provide it on the command line.
ZERO FALLBACK: output extension '.x' incompatible with family ... Expected '.y'
Добавьте названный флаг или исправьте расширение --output. Обоснование: Принципы ZERO.
Error: only one execution mode flag can be passed at a time — используйте только один из --compiled, --sequential, --triton, --triton-sequential.ERROR: Invalid model reference — для import нужен org/Model.ERROR: Model '<org/name>' not found on registry. — проверьте имя в каталоге.Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all — neurobrix clean нужен один из них.sudo это каталог root.| Код | Значение |
|---|---|
| 0 | Успех (doctor: блокирующих проблем нет) |
| 1 | Ошибка (Error: ...; некоторые сообщения import: ERROR: ...), doctor нашёл проблемы или validate нашёл недействительный файл |
| 2 | hub: реестр отклонил запрос, например неизвестная категория |
| 130 | Прервано по Ctrl-C |
neurobrix run завершается с ненулевым статусом самого запуска.
Запустите neurobrix -v <command>, чтобы увидеть строки разработчика движка (-vv добавляет traceback ошибки; NBX_LOG=debug в окружении включает оба), и сообщите о проблеме, приложив вывод neurobrix doctor --json.
Справочник CLI · Установка по оборудованию
© 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Ü