Gecontroleerd tegen neurobrix 0.6.15 (de opdrachtregelparser op tag v0.6.15, waarvan de gegenereerde referentie docs/reference/cli.md is). Voer een willekeurige opdracht uit met --help voor de gezaghebbende lijst.
neurobrix --version # NeuroBrix v0.6.15
Een subopdracht is vereist. Opdrachten: run, serve, chat, stop, upscale, hub, import, list, remove, clean, info, inspect, validate, doctor.
De ontwikkelaarsopdrachten calibrate, autotune, drift en coverage worden getoond door neurobrix --help -v, niet door neurobrix --help. Elke opdracht accepteert -v (de ontwikkelaarsregels van de engine) en -vv (ook de traceback van een fout).
| Code | Betekenis |
|---|---|
| 0 | Succes, --help en --version (doctor: geen blokkerend probleem gevonden; validate: alle bestanden geldig) |
| 1 | Een fout, getoond als Error: ... (sommige meldingen van import: ERROR: ...); doctor: problemen gevonden; validate: een bestand is ongeldig |
| 2 | Geen subcommando of een onbekende flag; hub: het register wees het verzoek af (bijvoorbeeld een onbekende categorie) |
| 130 | Onderbroken met Ctrl+C |
run eindigt met de niet-nul-status van de run zelf.
--json (bij info, inspect, list, remove, import, hub, doctor, validate, en bij run met --explain-plan) drukt één JSON-record af op stdout en de leesbare regels op stderr. import --json geeft één JSON-gebeurtenis per regel.
Een model heeft één naam, zijn hubnaam org/Model (hoofdlettergevoelig). import legt die naam vast naast het geïnstalleerde model, en run, serve, upscale, inspect, remove en list gebruiken hem; er is geen tweede, korte naam. Een model dat vóór 0.6.3 is geïnstalleerd, behoudt zijn mapnaam totdat neurobrix import org/Model er één keer voor wordt uitgevoerd (er wordt niets opnieuw gedownload).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
Kokoro-82M spreekt Engels (Amerikaans lexicon); kies een Engelse stem, bijvoorbeeld af_heart.
neurobrix hubBlader door het register (aanmelden is niet nodig).
| Flag | Beschrijving |
|---|---|
--category, -c |
Filter op categorie (voor u in hoofdletters gezet) |
--search, -s |
Zoeken op tekst |
--registry |
Registry-URL (standaard https://neurobrix.org; versies vóór 0.6.5 bereiken https://neurobrix.es, nog steeds bediend) |
--json |
Machineleesbare uitvoer |
neurobrix hub --category IMAGE
Een onbekende categorie toont Error: unknown category '<value>' (valid categories: ...) (de lijst komt van de registry) en eindigt met 2. De geldige waarden staan in Modelhub.
neurobrix import ORG/NAMEEen model downloaden en installeren.
| Flag | Beschrijving |
|---|---|
--registry |
Register-URL |
--force |
Een al geïnstalleerd model opnieuw installeren |
--no-keep |
De gedownloade .nbx na het uitpakken verwijderen (standaard blijft die in ~/.neurobrix/store/) |
--container FILE.nbx |
Installeert vanuit een container die de machine al heeft, gecontroleerd tegen de sha256 die de hub levert; er wordt niets gedownload |
--accept-license |
Een afgeschermde licentie accepteren zonder de prompt |
--json |
Eén JSON-gebeurtenis per regel |
neurobrix import hexgrad/Kokoro-82M
Wat er gebeurt, op volgorde: het model wordt opgezocht (ERROR: Model 'org/name' not found on registry. als het ontbreekt), de licentie wordt gecontroleerd, de download wordt aangevraagd en gestreamd, het archief wordt gecontroleerd en daarna uitgepakt naar ~/.neurobrix/cache/. De laatste regel is Installed org/name · run: <command>.
<file>.nbx.part. Voer dezelfde opdracht opnieuw uit en hij hervat met een HTTP-Range-verzoek.ERROR: not enough disk for this import). Het piekgebruik is ongeveer tweemaal de archiefgrootte, tenzij u --no-keep meegeeft.org/name is already installed (--force re-downloads). en eindigt met 0, behalve met --force.Accept license terms? [yes/No]. Geef in een niet-interactieve shell --accept-license mee of zet NBX_ACCEPT_LICENSE=1, anders: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (exit 1). Acceptatie wordt lokaal onthouden. Zie Licenties.sha256sum) met de sha256 uit de API. Een container die met --container wordt opgegeven, wordt vóór al het andere tegen die sha256 gecontroleerd.| Opdracht | Beschrijving |
|---|---|
neurobrix list [--store] [--json] |
Geïnstalleerde modellen, op naam (--store: ook de gedownloade archieven) |
neurobrix remove MODEL [--store] [--all] [--json] |
Een model verwijderen. Standaard alleen de uitgepakte kopie; --store het archief, --all beide |
neurobrix clean [--store] [--cache] [--all] [-y] |
Leegt de store en/of de cache. Zonder een van de drie vlaggen: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (exit 1) |
| Opdracht | Beschrijving |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
Overzicht van engine, modellen en hardware |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
In een .nbx-bestand of een geïnstalleerd model kijken |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
Controleert een of meer .nbx-bestanden. Niveaus (--level, -l): structure, schema, coherence (standaard), deep. Exit 0 als alle bestanden geldig zijn, anders 1 |
neurobrix doctor [--json] |
Controleert de installatie: PATH, de Triton-engine (versies van nbxtensor en Triton), PyTorch en zijn CUDA-build (optioneel), de GPU's die het proces ziet |
doctor eindigt met 0 en "No blocking problem found", of met 1 en de problemen met de oplossing voor elk (1 ook als geen enkele engine kan draaien). PyTorch engine: not installed (optional; ...) is alleen blokkerend als de Triton-engine ook niet kan draaien; de PyTorch-wheel die het voorstelt, hangt af van de GPU (een V100 krijgt cu126). Met --json drukt het {"schema", "engine", "ok": bool, "problems": [...]} af. Op Apple Silicon meldt het de Apple-GPU (Metal). Zie Installeren per hardware.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
--model mag alleen worden weggelaten als er een serving-daemon draait (Error: --model is required when no daemon is running.). Terwijl een daemon een ander model serveert, wordt een koude run geweigerd (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.); met hetzelfde model gebruikt de run de warme daemon.
Algemene opties
| Flag | Beschrijving |
|---|---|
--hardware |
Hardwareprofiel (automatisch gedetecteerd indien weggelaten) |
--explain-plan |
Toont het plaatsingsplan en stopt dan zonder iets te laden |
--json |
Met --explain-plan: het plan als één JSON-record |
--prompt |
Tekstprompt |
--output |
Uitvoerbestand. Standaard output_<model>.<ext>; de extensie moet bij de modelfamilie passen |
--seed, --set KEY=VALUE |
Seed; een modelstandaard overschrijven (herhaalbaar) |
--certified-only |
Hetzelfde als NBX_AUTOTUNE_CERTIFIED_ONLY=1 (ook bij calibrate en drift) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
Uitvoeringsmodus (hoogstens één; standaard is --compiled als PyTorch geïnstalleerd is, anders --triton): --compiled, --sequential, --triton, --triton-sequential. Meer dan één meegeven: Error: only one execution mode flag can be passed at a time (exit 1).
Per familie
| Flag | Gebruikt door |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
Taalmodellen |
--turns FILE |
Taalmodellen: een JSON-lijst van gebruikersberichten, afgespeeld als één chatsessie, beurt na beurt |
--steps, --cfg, --height, --width |
Beeld- en videogeneratie |
--input-image, --mask-image |
Beeld-naar-beeld, inpainting, vision-language |
--num-frames, --fps, --input-video, --video |
Video |
--audio |
Spraak naar tekst, audio-taalmodellen |
--speaker |
Tekst-naar-spraak |
--reference-audio, --reference-image |
In deze versie niet aangesloten: bij naam geweigerd |
Een eerste opdracht voor elke familie
neurobrix run --model <llm> --prompt "Explain ZFS in one paragraph" --max-tokens 256
neurobrix run --model <image> --prompt "a lighthouse at dusk" --steps 30 --output out.png
neurobrix run --model <video> --prompt "waves on a beach" --num-frames 33 --output out.mp4
neurobrix run --model <tts> --prompt "Hello" --speaker <voice> --output hello.wav
neurobrix run --model <stt> --audio speech.wav
neurobrix run --model <vlm> --prompt "Describe this" --input-image photo.png
De vereiste invoer hangt af van de familie. Een ontbrekende stopt de uitvoering met ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line., en een verkeerde uitvoerextensie met ZERO FALLBACK: output extension '.x' incompatible with family .... Visie-taalmodellen hebben --prompt en --input-image nodig; audio-taalmodellen hebben --audio en --prompt nodig; multimodale modellen hebben --mode text|image|audio nodig.
Waar spraak-naar-tekst zijn transcript schrijft wanneer --output is weggelaten, is nog niet gedocumenteerd.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| Flag | Beschrijving |
|---|---|
--model |
Vereist |
--input, --input-image |
Vereist, de bronafbeelding |
--output |
Vereist, een PNG-pad |
--mode |
compiled (standaard), sequential, triton, triton-sequential |
--hardware |
Hardwareprofiel |
Een ontbrekende invoer toont Error: input image not found: <path> (exit 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| Opdracht | Flags |
|---|---|
serve |
--model (verplicht), --hardware, --timeout (seconden inactiviteit, standaard 1800), --foreground, --http (serveert ook de OpenAI-compatibele HTTP-API, standaard 127.0.0.1:8765), --http-host, --http-port, --api-key-file (verplicht voor een ander adres dan loopback), --ready-fd / --ready-file (voor een programma dat de daemon start: waar het JSON-gereedrecord van één regel wordt geschreven), vlaggen voor de uitvoeringsmodus |
chat |
--max-tokens, --temperature, --repetition-penalty. In chat: /new, /context, /status, /quit |
stop |
geen; vraagt de daemon af te sluiten, beëindigt hem zo nodig en ruimt verouderde bestanden op |
Als er al een daemon bestaat, toont serve Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it en eindigt met 1. Eén taak tegelijk. Meer in de Serving-gids en in Serving and chat.
Volgende: Configuratie
© 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Ü