| Python | 3.10 o successivo (sono dichiarati 3.10, 3.11 e 3.12). |
| PyTorch | Facoltativo. pip install neurobrix installa il motore Triton (nbxtensor 0.1.7 e Triton), che non richiede PyTorch. Il motore PyTorch si aggiunge con pip install "neurobrix[pytorch]", dopo la build di PyTorch adatta al vostro hardware — vedere Installazione per hardware. |
| Disco | 1,48 GiB per il solo motore Triton, 6,82 GiB con il motore PyTorch (misurati in un container python:3.10-slim pulito il 2026-11-06), più circa il doppio della dimensione di ogni modello importato. Vedere Risoluzione dei problemi. |
| Sistema operativo | Linux e Windows (entrambi i motori). macOS su Apple Silicon: il motore Triton tramite Metal, il motore PyTorch tramite MPS. |
| Driver / compute capability | Non è ancora indicato alcun minimo. Eseguire neurobrix doctor. |
Debian, Ubuntu, Fedora e altre distribuzioni che seguono PEP 668 rifiutano un semplice pip install (error: externally-managed-environment). Usare un ambiente virtuale:
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Risultato atteso: una riga Successfully installed ... che nomina neurobrix-0.6.15, con nbxtensor-0.1.7 e, sulle piattaforme coperte dalle sue wheel, nbxgrammar-0.1.1.
Su Debian e Ubuntu, python3 -m venv può richiedere prima un pacchetto:
sudo apt update && sudo apt install -y python3-venv
pipx install neurobrix
neurobrix --version
Risultato atteso: NeuroBrix v0.6.15.
neurobrix doctor
Risultato atteso: No blocking problem found e codice di uscita 0. Se segnala un problema, stampa il comando che lo risolve. doctor controlla il PATH, se il motore Triton può funzionare (nbxtensor, Triton e un runtime GPU), quale build di PyTorch è installata, se presente, e se vede le GPU che il driver riporta. Usate neurobrix doctor --json negli script.
Per impostazione predefinita pip install neurobrix non installa PyTorch: un'esecuzione usa il motore Triton. Su un Mac, la build di Triton per le GPU Apple si aggiunge con python -m nbxtensor install-metal. Se aggiungete il motore PyTorch, la sua build deve corrispondere alla vostra scheda. Scegliete il vostro caso in Installazione per hardware.
Triton è una dipendenza di neurobrix su Linux e Windows; PyPI non pubblica Triton per macOS, quindi python -m nbxtensor install-metal installa la build di NeuroBrix per le GPU Apple. Senza flag di modalità, un'esecuzione usa il motore PyTorch dove PyTorch è installato e il motore Triton dove non lo è, e la sua riga di avvio dice quale.
pip install "neurobrix[adapter]"
L'extra adapter aggiunge librerie di tokenizzazione e audio. Quali modelli ne hanno bisogno non è ancora documentato. L'extra pytorch aggiunge il motore PyTorch. Non esiste un extra cuda né cpu.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Entrambe le cartelle si trovano nella home dell'utente che invoca il comando. Un modello importato da un utente non è visibile a un altro, nemmeno con sudo.
Installazione per hardware · poi la prima ora
© 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Ü