| Python | 3.10 или новее (заявлены 3.10, 3.11 и 3.12). |
| PyTorch | Необязателен. pip install neurobrix устанавливает движок Triton (nbxtensor 0.1.7 и Triton), которому PyTorch не нужен. Движок PyTorch добавляется командой pip install "neurobrix[pytorch]" после сборки PyTorch, подходящей вашему оборудованию — см. Установка по оборудованию. |
| Диск | 1,48 ГиБ только для движка Triton, 6,82 ГиБ с движком PyTorch (измерено в чистом контейнере python:3.10-slim 2026-11-06), плюс примерно двойной размер каждой импортируемой модели. См. Устранение неполадок. |
| ОС | Linux и Windows (оба движка). macOS на Apple Silicon: движок Triton через Metal, движок PyTorch через MPS. |
| Драйвер / compute capability | Минимум пока не указан. Выполните neurobrix doctor. |
Debian, Ubuntu, Fedora и другие дистрибутивы, следующие PEP 668, отказываются от обычного pip install (error: externally-managed-environment). Используйте виртуальное окружение:
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Ожидаемый результат: строка Successfully installed ... с neurobrix-0.6.15, а также nbxtensor-0.1.7 и, на платформах, для которых есть его wheel-пакеты, nbxgrammar-0.1.1.
В Debian и Ubuntu для python3 -m venv сначала может понадобиться один пакет:
sudo apt update && sudo apt install -y python3-venv
pipx install neurobrix
neurobrix --version
Ожидаемый результат: NeuroBrix v0.6.15.
neurobrix doctor
Ожидаемый результат: No blocking problem found и код выхода 0. Если обнаружена проблема, выводится команда, которая её исправляет. doctor проверяет PATH, может ли работать движок Triton (nbxtensor, Triton и среда выполнения GPU), какая сборка PyTorch установлена, если она есть, и видит ли он GPU, о которых сообщает драйвер. В скриптах используйте neurobrix doctor --json.
По умолчанию pip install neurobrix не устанавливает PyTorch: запуск идёт на движке Triton. На Mac сборка Triton для GPU Apple добавляется командой python -m nbxtensor install-metal. Если вы добавляете движок PyTorch, его сборка должна соответствовать вашей карте. Выберите свой случай в разделе Установка по оборудованию.
Triton — зависимость neurobrix в Linux и Windows; PyPI не публикует Triton для macOS, поэтому python -m nbxtensor install-metal устанавливает сборку NeuroBrix для GPU Apple. Без флага режима запуск использует движок PyTorch там, где установлен PyTorch, и движок Triton там, где его нет, а строка запуска сообщает, какой именно.
pip install "neurobrix[adapter]"
Дополнение adapter добавляет библиотеки токенизации и работы со звуком. Каким моделям оно нужно, пока не задокументировано. Дополнение pytorch добавляет движок PyTorch. Дополнений cuda и cpu нет.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Оба каталога находятся в домашнем каталоге вызвавшего пользователя. Модель, импортированная одним пользователем, не видна другому, в том числе под sudo.
Установка по оборудованию · затем первый час
© 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Ü