| Python | 3.10 of nieuwer (3.10, 3.11 en 3.12 zijn gedeclareerd). |
| PyTorch | Optioneel. pip install neurobrix installeert de Triton-engine (nbxtensor 0.1.7 en Triton), die geen PyTorch nodig heeft. De PyTorch-engine voegt u toe met pip install "neurobrix[pytorch]", na de PyTorch-build voor uw hardware — zie Installeren per hardware. |
| Schijf | 1,48 GiB voor alleen de Triton-engine, 6,82 GiB met de PyTorch-engine (gemeten in een schone python:3.10-slim-container op 2026-11-06), plus ongeveer twee keer de grootte van elk model dat u importeert. Zie Probleemoplossing. |
| Besturingssysteem | Linux en Windows (beide engines). macOS op Apple Silicon: de Triton-engine via Metal, de PyTorch-engine via MPS. |
| Stuurprogramma / compute capability | Er is nog geen minimum opgegeven. Voer neurobrix doctor uit. |
Debian, Ubuntu, Fedora en andere distributies die PEP 668 volgen, weigeren een gewone pip install (error: externally-managed-environment). Gebruik een virtuele omgeving:
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Verwacht resultaat: een regel Successfully installed ... die neurobrix-0.6.15 noemt, met nbxtensor-0.1.7 en, op de platforms waarvoor wheels bestaan, nbxgrammar-0.1.1.
Op Debian en Ubuntu heeft python3 -m venv mogelijk eerst één pakket nodig:
sudo apt update && sudo apt install -y python3-venv
pipx install neurobrix
neurobrix --version
Verwacht resultaat: NeuroBrix v0.6.15.
neurobrix doctor
Verwacht resultaat: No blocking problem found en exitcode 0. Meldt het een probleem, dan toont het de opdracht die het oplost. doctor controleert het PATH, of de Triton-engine kan draaien (nbxtensor, Triton en een GPU-runtime), welke PyTorch-build eventueel geïnstalleerd is, en of het de GPU's ziet die uw driver meldt. Gebruik neurobrix doctor --json in scripts.
Standaard installeert pip install neurobrix geen PyTorch: een run gebruikt de Triton-engine. Op een Mac voegt u de Triton-build voor Apple-GPU's toe met python -m nbxtensor install-metal. Voegt u de PyTorch-engine toe, dan moet de build bij uw kaart passen. Kies uw situatie in Installeren per hardware.
Triton is op Linux en Windows een afhankelijkheid van neurobrix; PyPI publiceert geen Triton voor macOS, dus python -m nbxtensor install-metal installeert de NeuroBrix-build voor Apple-GPU's. Zonder modusvlag gebruikt een run de PyTorch-engine waar PyTorch geïnstalleerd is en anders de Triton-engine, en de startregel zegt welke.
pip install "neurobrix[adapter]"
De extra adapter voegt tokenizer- en audiobibliotheken toe. Welke modellen die nodig hebben, is nog niet gedocumenteerd. De extra pytorch voegt de PyTorch-engine toe. Er is geen extra cuda of cpu.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Beide staan onder de thuismap van de aanroepende gebruiker. Een model dat als de ene gebruiker is geïmporteerd, is niet zichtbaar voor een andere, ook niet onder sudo.
Installeren per hardware · daarna het eerste uur
© 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Ü