| Python | 3.10 oder neuer (3.10, 3.11 und 3.12 sind deklariert). |
| PyTorch | Optional. pip install neurobrix installiert die Triton-Engine (nbxtensor 0.1.7 und Triton), die kein PyTorch braucht. Die PyTorch-Engine kommt mit pip install "neurobrix[pytorch]" hinzu, nach dem PyTorch-Build für deine Hardware — siehe Installation nach Hardware. |
| Speicherplatz | 1,48 GiB für die Triton-Engine allein, 6,82 GiB mit der PyTorch-Engine (gemessen in einem frischen python:3.10-slim-Container am 2026-11-06), dazu etwa das Doppelte der Größe jedes importierten Modells. Siehe Fehlerbehebung. |
| Betriebssystem | Linux und Windows (beide Engines). macOS auf Apple Silicon: die Triton-Engine über Metal, die PyTorch-Engine über MPS. |
| Treiber / Compute Capability | Noch kein Minimum angegeben. Führe neurobrix doctor aus. |
Debian, Ubuntu, Fedora und andere Distributionen, die PEP 668 folgen, verweigern ein einfaches pip install (error: externally-managed-environment). Verwende eine virtuelle Umgebung:
python3 -m venv nbx
source nbx/bin/activate
pip install neurobrix
Erwartetes Ergebnis: eine Zeile Successfully installed ..., die neurobrix-0.6.15 nennt, mit nbxtensor-0.1.7 und, auf den Plattformen, für die es Wheels gibt, nbxgrammar-0.1.1.
Unter Debian und Ubuntu braucht python3 -m venv eventuell vorab ein Paket:
sudo apt update && sudo apt install -y python3-venv
pipx install neurobrix
neurobrix --version
Erwartetes Ergebnis: NeuroBrix v0.6.15.
neurobrix doctor
Erwartetes Ergebnis: No blocking problem found und Exit-Code 0. Meldet es ein Problem, gibt es den Befehl aus, der es behebt. doctor prüft den PATH, ob die Triton-Engine laufen kann (nbxtensor, Triton und eine GPU-Laufzeit), welcher PyTorch-Build gegebenenfalls installiert ist und ob es die GPUs sieht, die dein Treiber meldet. Nutze neurobrix doctor --json in Skripten.
Standardmäßig installiert pip install neurobrix kein PyTorch: ein Lauf nimmt die Triton-Engine. Auf einem Mac kommt der Triton-Build für Apple-GPUs mit python -m nbxtensor install-metal hinzu. Wenn du die PyTorch-Engine hinzufügst, muss ihr Build zu deiner Karte passen. Wähle deinen Fall unter Installation nach Hardware.
Triton ist unter Linux und Windows eine Abhängigkeit von neurobrix; PyPI veröffentlicht kein Triton für macOS, daher installiert python -m nbxtensor install-metal den NeuroBrix-Build für Apple-GPUs. Ohne Modus-Flag nimmt ein Lauf die PyTorch-Engine, wo PyTorch installiert ist, sonst die Triton-Engine, und seine Startzeile sagt, welche.
pip install "neurobrix[adapter]"
Das Extra adapter fügt Tokenizer- und Audiobibliotheken hinzu. Welche Modelle es brauchen, ist noch nicht dokumentiert. Das Extra pytorch fügt die PyTorch-Engine hinzu. Es gibt kein Extra cuda oder cpu.
~/.neurobrix/
├── store/ # downloaded .nbx archives (and .part files while downloading)
└── cache/ # extracted models — this is what the runtime loads
Beide liegen im Home-Verzeichnis des aufrufenden Benutzers. Ein als ein Benutzer importiertes Modell ist für einen anderen nicht sichtbar, auch nicht unter sudo.
Installation nach Hardware · danach die erste Stunde
© 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Ü