| Python | 3.10 ou plus récent (3.10, 3.11 et 3.12 sont déclarés). |
| PyTorch | Facultatif. pip install neurobrix installe le moteur Triton (nbxtensor 0.1.7 et Triton), qui n'a pas besoin de PyTorch. Le moteur PyTorch s'ajoute avec pip install "neurobrix[pytorch]", après la version de PyTorch adaptée à votre matériel — voir Installer selon le matériel. |
| Disque | 1,48 Gio pour le moteur Triton seul, 6,82 Gio avec le moteur PyTorch (mesuré dans un conteneur python:3.10-slim vierge le 2026-11-06), plus environ deux fois la taille de chaque modèle importé. Voir Dépannage. |
| Système | Linux et Windows (les deux moteurs). macOS sur Apple Silicon : le moteur Triton via Metal, le moteur PyTorch via MPS. |
| Pilote / capacité de calcul | Aucun minimum n'est encore indiqué. Lancez neurobrix doctor. |
Debian, Ubuntu, Fedora et les autres distributions qui suivent PEP 668 refusent un simple pip install (error: externally-managed-environment). Utilisez un environnement virtuel :
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Résultat attendu : une ligne Successfully installed ... qui nomme neurobrix-0.6.15, avec nbxtensor-0.1.7 et, sur les plateformes couvertes par ses wheels, nbxgrammar-0.1.1.
Sous Debian et Ubuntu, python3 -m venv peut nécessiter d'abord un paquet :
sudo apt update && sudo apt install -y python3-venv
pipx install neurobrix
neurobrix --version
Résultat attendu : NeuroBrix v0.6.15.
neurobrix doctor
Résultat attendu : No blocking problem found et le code de sortie 0. S'il signale un problème, il affiche la commande qui le corrige. doctor vérifie le PATH, si le moteur Triton peut tourner (nbxtensor, Triton et un runtime GPU), quelle version de PyTorch est installée le cas échéant, et s'il voit les GPU que signale votre pilote. Utilisez neurobrix doctor --json dans les scripts.
Par défaut, pip install neurobrix n'installe pas PyTorch : une exécution prend le moteur Triton. Sur un Mac, la version de Triton pour les GPU Apple s'ajoute avec python -m nbxtensor install-metal. Si vous ajoutez le moteur PyTorch, sa version doit correspondre à votre carte. Choisissez votre cas dans Installer selon le matériel.
Triton est une dépendance de neurobrix sous Linux et Windows ; PyPI ne publie pas de Triton pour macOS, donc python -m nbxtensor install-metal installe la version de NeuroBrix pour les GPU Apple. Sans option de mode, une exécution prend le moteur PyTorch là où PyTorch est installé et le moteur Triton ailleurs, et sa ligne de lancement dit lequel.
pip install "neurobrix[adapter]"
L'extra adapter ajoute des bibliothèques de tokenisation et d'audio. Les modèles qui en ont besoin ne sont pas encore documentés. L'extra pytorch ajoute le moteur PyTorch. Il n'existe pas d'extra cuda ni cpu.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Les deux se trouvent dans le répertoire personnel de l'utilisateur appelant. Un modèle importé par un utilisateur n'est pas visible d'un autre, y compris sous sudo.
Installer selon le matériel · puis la première heure
© 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Ü