Verificat amb neurobrix 0.6.15 (l'analitzador de la línia d'ordres a l'etiqueta v0.6.15, la referència generada del qual és docs/reference/cli.md). Executeu qualsevol ordre amb --help per a la llista de referència.
neurobrix --version # NeuroBrix v0.6.15
Cal una subordre. Ordres: run, serve, chat, stop, upscale, hub, import, list, remove, clean, info, inspect, validate, doctor.
Les ordres de desenvolupament calibrate, autotune, drift i coverage les llista neurobrix --help -v, no neurobrix --help. Totes les ordres accepten -v (les línies de desenvolupament del motor) i -vv (a més, el traceback d'un error).
| Codi | Significat |
|---|---|
| 0 | Èxit, --help i --version (doctor: cap problema bloquejant; validate: tots els fitxers vàlids) |
| 1 | Un error, mostrat com a Error: ... (alguns missatges d'import: ERROR: ...); doctor: problemes trobats; validate: un fitxer no és vàlid |
| 2 | Cap subordre o un indicador desconegut; hub: el registre ha rebutjat la petició (per exemple una categoria desconeguda) |
| 130 | Interromput amb Ctrl+C |
run surt amb l'estat diferent de zero de la mateixa execució.
--json (a info, inspect, list, remove, import, hub, doctor, validate, i a run amb --explain-plan) imprimeix un registre JSON a stdout i les línies llegibles a stderr. import --json emet un esdeveniment JSON per línia.
Un model té un sol nom, el seu nom al hub org/Model (distingeix majúscules). import registra aquest nom al costat del model instal·lat, i run, serve, upscale, inspect, remove i list el fan servir; no hi ha cap segon nom curt. Un model instal·lat abans de la 0.6.3 conserva el nom del directori fins que s'executa una vegada neurobrix import org/Model per a ell (no es torna a baixar res).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
Kokoro-82M parla anglès (lèxic nord-americà); trieu una veu anglesa, per exemple af_heart.
neurobrix hubNavegueu pel registre (no cal iniciar sessió).
| Indicador | Descripció |
|---|---|
--category, -c |
Filtra per categoria (es converteix a majúscules per vosaltres) |
--search, -s |
Cerca per text |
--registry |
URL del registre (per defecte https://neurobrix.org; les versions anteriors a la 0.6.5 fan servir https://neurobrix.es, que continua en servei) |
--json |
Sortida llegible per màquina |
neurobrix hub --category IMAGE
Una categoria desconeguda mostra Error: unknown category '<value>' (valid categories: ...) (la llista ve del registre) i surt amb el codi 2. Els valors vàlids són a Hub de models.
neurobrix import ORG/NAMEDescarrega i instal·la un model.
| Indicador | Descripció |
|---|---|
--registry |
URL del registre |
--force |
Reinstal·la un model que ja està instal·lat |
--no-keep |
Esborra el .nbx descarregat després d'extreure'l (per defecte el conserva a ~/.neurobrix/store/) |
--container FILE.nbx |
Instal·la des d'un contenidor que la màquina ja té, verificat amb el sha256 que serveix el hub; no es baixa res |
--accept-license |
Accepta una llicència restringida sense preguntar |
--json |
Un esdeveniment JSON per línia |
neurobrix import hexgrad/Kokoro-82M
Què passa, per ordre: es cerca el model (ERROR: Model 'org/name' not found on registry. si no existeix), es comprova la llicència, es demana i es rep la baixada, es comprova l'arxiu i s'extreu a ~/.neurobrix/cache/. La darrera línia és Installed org/name · run: <command>.
<file>.nbx.part. Torneu a executar la mateixa ordre i es reprèn amb una petició HTTP Range.ERROR: not enough disk for this import). L'ús màxim és aproximadament el doble de la mida de l'arxiu tret que passeu --no-keep.org/name is already installed (--force re-downloads). i surt amb 0, tret que s'hi afegeixi --force.Accept license terms? [yes/No]. En un intèrpret no interactiu passeu --accept-license o definiu NBX_ACCEPT_LICENSE=1, si no: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (sortida 1). L'acceptació es recorda localment. Vegeu Llicències.sha256sum) amb el sha256 de l'API. Un contenidor indicat amb --container es verifica amb aquest sha256 abans de res.| Ordre | Descripció |
|---|---|
neurobrix list [--store] [--json] |
Models instal·lats, per nom (--store: també els arxius baixats) |
neurobrix remove MODEL [--store] [--all] [--json] |
Elimina un model. Per defecte elimina només la còpia extreta; --store l'arxiu, --all tots dos |
neurobrix clean [--store] [--cache] [--all] [-y] |
Buida el store i/o la memòria cau. Sense cap dels tres indicadors: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (sortida 1) |
| Ordre | Descripció |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
Resum del motor, els models i el maquinari |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
Mira dins d'un fitxer .nbx o d'un model instal·lat |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
Comprova un o més fitxers .nbx. Nivells (--level, -l): structure, schema, coherence (per defecte), deep. Sortida 0 quan tots els fitxers són vàlids, 1 si no |
neurobrix doctor [--json] |
Comprova la instal·lació: PATH, el motor Triton (versions de nbxtensor i Triton), PyTorch i la seva versió CUDA (opcional), les GPU que veu el procés |
doctor surt amb 0 i "No blocking problem found", o amb 1 i els problemes amb la correcció de cadascun (1 també quan cap motor no pot funcionar). PyTorch engine: not installed (optional; ...) només és bloquejant si el motor Triton tampoc no pot funcionar; la wheel de PyTorch que suggereix depèn de la GPU (una V100 rep cu126). Amb --json imprimeix {"schema", "engine", "ok": bool, "problems": [...]}. A Apple Silicon informa de la GPU d'Apple (Metal). Vegeu Instal·lar segons el maquinari.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
--model només es pot ometre quan hi ha un dimoni de servei en marxa (Error: --model is required when no daemon is running.). Mentre un dimoni serveix un altre model, una execució en fred es rebutja (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.); amb el mateix model, l'execució fa servir el dimoni en calent.
Opcions comunes
| Indicador | Descripció |
|---|---|
--hardware |
Perfil de maquinari (detectat automàticament si s'omet) |
--explain-plan |
Mostra el pla de col·locació i surt sense carregar res |
--json |
Amb --explain-plan: el pla com un sol registre JSON |
--prompt |
Prompt de text |
--output |
Fitxer de sortida. Per defecte output_<model>.<ext>; l'extensió ha de coincidir amb la família del model |
--seed, --set KEY=VALUE |
Llavor; sobreescriu un valor per defecte del model (es pot repetir) |
--certified-only |
Equival a NBX_AUTOTUNE_CERTIFIED_ONLY=1 (també a calibrate i drift) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
Mode d'execució (com a màxim un; el per defecte és --compiled si PyTorch està instal·lat, si no --triton): --compiled, --sequential, --triton, --triton-sequential. Passar-ne més d'un: Error: only one execution mode flag can be passed at a time (sortida 1).
Per família
| Indicador | Utilitzat per |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
Models de llenguatge |
--turns FILE |
Models de llenguatge: una llista JSON de missatges de l'usuari reproduïda com una sola sessió de xat, torn rere torn |
--steps, --cfg, --height, --width |
Generació d'imatge i de vídeo |
--input-image, --mask-image |
Imatge a imatge, inpainting, visió-llenguatge |
--num-frames, --fps, --input-video, --video |
Vídeo |
--audio |
De veu a text, models de llenguatge d'àudio |
--speaker |
Text a veu |
--reference-audio, --reference-image |
No connectats en aquesta versió: es rebutgen pel seu nom |
Una primera ordre per a cada família
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
Les entrades obligatòries depenen de la família. Si en falta una, l'execució s'atura amb ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line., i una extensió de sortida incorrecta amb ZERO FALLBACK: output extension '.x' incompatible with family .... Els models de visió i llenguatge necessiten --prompt i --input-image; els models de llenguatge d'àudio necessiten --audio i --prompt; els models multimodals necessiten --mode text|image|audio.
On escriu la transcripció la conversió de veu a text quan s'omet --output encara no està documentat.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| Indicador | Descripció |
|---|---|
--model |
Obligatori |
--input, --input-image |
Obligatori, la imatge d'origen |
--output |
Obligatori, una ruta PNG |
--mode |
compiled (per defecte), sequential, triton, triton-sequential |
--hardware |
Perfil de maquinari |
Una entrada que falta mostra Error: input image not found: <path> (sortida 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| Ordre | Indicadors |
|---|---|
serve |
--model (obligatori), --hardware, --timeout (segons d'inactivitat, 1800 per defecte), --foreground, --http (serveix també l'API HTTP compatible amb OpenAI, per defecte 127.0.0.1:8765), --http-host, --http-port, --api-key-file (obligatori per a una adreça que no sigui loopback), --ready-fd / --ready-file (per a un programa que llança el dimoni: on escriure el registre JSON d'una línia que indica que està llest), indicadors de mode d'execució |
chat |
--max-tokens, --temperature, --repetition-penalty. Dins del xat: /new, /context, /status, /quit |
stop |
cap; demana al dimoni que surti, després l'acaba si cal, i neteja els fitxers obsolets |
Si ja hi ha un dimoni, serve mostra Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it i surt amb 1. Una tasca alhora. Més a la Guia de servei i a Serving and chat.
Següent: Configuració
© 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Ü