| Python | 3.10 ou mais recente (3.10, 3.11 e 3.12 estão declarados). |
| PyTorch | Opcional. pip install neurobrix instala o motor Triton (nbxtensor 0.1.7 e Triton), que não precisa de PyTorch. O motor PyTorch acrescenta-se com pip install "neurobrix[pytorch]", depois da versão de PyTorch adequada ao seu hardware — veja Instalar por hardware. |
| Disco | 1,48 GiB só para o motor Triton, 6,82 GiB com o motor PyTorch (medido num contentor python:3.10-slim limpo a 2026-11-06), mais cerca do dobro do tamanho de cada modelo que importar. Veja Resolução de problemas. |
| Sistema | Linux e Windows (os dois motores). macOS em Apple Silicon: o motor Triton através de Metal, o motor PyTorch através de MPS. |
| Driver / compute capability | Ainda não é indicado nenhum mínimo. Execute neurobrix doctor. |
O Debian, o Ubuntu, o Fedora e outras distribuições que seguem a PEP 668 recusam um pip install simples (error: externally-managed-environment). Use um ambiente virtual:
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Resultado esperado: uma linha Successfully installed ... que indica neurobrix-0.6.15, com nbxtensor-0.1.7 e, nas plataformas cobertas pelas suas wheels, nbxgrammar-0.1.1.
No Debian e no Ubuntu, o python3 -m venv pode precisar primeiro de um pacote:
sudo apt update && sudo apt install -y python3-venv
pipx install neurobrix
neurobrix --version
Resultado esperado: NeuroBrix v0.6.15.
neurobrix doctor
Resultado esperado: No blocking problem found e código de saída 0. Se indicar um problema, mostra o comando que o corrige. O doctor verifica o PATH, se o motor Triton pode correr (nbxtensor, Triton e um runtime de GPU), que versão do PyTorch está instalada, se existir, e se vê as GPU que o seu controlador indica. Use neurobrix doctor --json em scripts.
Por omissão, pip install neurobrix não instala o PyTorch: uma execução usa o motor Triton. Num Mac, a versão do Triton para GPU Apple acrescenta-se com python -m nbxtensor install-metal. Se acrescentar o motor PyTorch, a versão tem de corresponder à sua placa. Escolha o seu caso em Instalar por hardware.
O Triton é uma dependência do neurobrix em Linux e Windows; o PyPI não publica Triton para macOS, por isso python -m nbxtensor install-metal instala a versão do NeuroBrix para GPU Apple. Sem opção de modo, uma execução usa o motor PyTorch onde o PyTorch está instalado e o motor Triton onde não está, e a sua linha de arranque diz qual.
pip install "neurobrix[adapter]"
O extra adapter acrescenta bibliotecas de tokenização e de áudio. Que modelos precisam dele ainda não está documentado. O extra pytorch acrescenta o motor PyTorch. Não existe extra cuda nem cpu.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Ambos ficam na pasta pessoal do utilizador que invoca. Um modelo importado por um utilizador não é visível para outro, incluindo com sudo.
Instalar por hardware · depois a primeira hora
© 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Ü