| Python | 3.10 o posterior (se declaran 3.10, 3.11 y 3.12). |
| PyTorch | Opcional. pip install neurobrix instala el motor Triton (nbxtensor 0.1.7 y Triton), que no necesita PyTorch. El motor PyTorch se añade con pip install "neurobrix[pytorch]", después de la versión de PyTorch adecuada para tu hardware — consulta Instalar según el hardware. |
| Disco | 1,48 GiB para el motor Triton solo, 6,82 GiB con el motor PyTorch (medido en un contenedor python:3.10-slim limpio el 2026-11-06), más aproximadamente el doble del tamaño de cada modelo que importes. Consulta Solución de problemas. |
| Sistema | Linux y Windows (los dos motores). macOS en Apple Silicon: el motor Triton mediante Metal, el motor PyTorch mediante MPS. |
| Controlador / capacidad de cómputo | Aún no se indica ningún mínimo. Ejecuta neurobrix doctor. |
Debian, Ubuntu, Fedora y otras distribuciones que siguen PEP 668 rechazan un pip install simple (error: externally-managed-environment). Usa un entorno virtual:
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Resultado esperado: una línea Successfully installed ... que nombra neurobrix-0.6.15, con nbxtensor-0.1.7 y, en las plataformas que cubren sus wheels, nbxgrammar-0.1.1.
En Debian y Ubuntu, python3 -m venv puede necesitar antes un paquete:
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 y código de salida 0. Si indica un problema, muestra el comando que lo corrige. doctor comprueba el PATH, si el motor Triton puede ejecutarse (nbxtensor, Triton y un runtime de GPU), qué versión de PyTorch está instalada si la hay, y si ve las GPU que informa tu controlador. Usa neurobrix doctor --json en scripts.
Por defecto, pip install neurobrix no instala PyTorch: una ejecución usa el motor Triton. En un Mac, la versión de Triton para las GPU de Apple se añade con python -m nbxtensor install-metal. Si añades el motor PyTorch, su versión debe corresponder a tu tarjeta. Elige tu caso en Instalar según el hardware.
Triton es una dependencia de neurobrix en Linux y Windows; PyPI no publica Triton para macOS, así que python -m nbxtensor install-metal instala la versión de NeuroBrix para las GPU de Apple. Sin opción de modo, una ejecución usa el motor PyTorch donde PyTorch está instalado y el motor Triton donde no lo está, y su línea de arranque indica cuál.
pip install "neurobrix[adapter]"
El extra adapter añade bibliotecas de tokenización y de audio. Qué modelos lo necesitan aún no está documentado. El extra pytorch añade el motor PyTorch. No existe ningún extra cuda ni cpu.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Ambos residen en el directorio personal del usuario que invoca. Un modelo importado por un usuario no es visible para otro, ni siquiera con sudo.
Instalar según el hardware · después la primera 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Ü