Verificado con neurobrix 0.6.15 (el analizador de la línea de comandos en la etiqueta v0.6.15, cuya referencia generada es docs/reference/cli.md). Ejecuta cualquier comando con --help para ver la lista de referencia.
neurobrix --version # NeuroBrix v0.6.15
Se requiere un subcomando. Comandos: run, serve, chat, stop, upscale, hub, import, list, remove, clean, info, inspect, validate, doctor.
Los comandos de desarrollo calibrate, autotune, drift y coverage aparecen con neurobrix --help -v, no con neurobrix --help. Todos los comandos aceptan -v (las líneas de desarrollo del motor) y -vv (además, el traceback de un error).
| Código | Significado |
|---|---|
| 0 | Éxito, --help y --version (doctor: ningún problema bloqueante; validate: todos los archivos válidos) |
| 1 | Un error, mostrado como Error: ... (algunos mensajes de import: ERROR: ...); doctor: problemas encontrados; validate: un archivo no es válido |
| 2 | Sin subcomando o con una opción desconocida; hub: el registro rechazó la petición (por ejemplo, una categoría desconocida) |
| 130 | Interrumpido con Ctrl+C |
run sale con el estado distinto de cero de la propia ejecución.
--json (en info, inspect, list, remove, import, hub, doctor, validate, y en run con --explain-plan) imprime un registro JSON en stdout y las líneas legibles en stderr. import --json emite un evento JSON por línea.
Un modelo tiene un solo nombre, su nombre en el hub org/Model (sensible a mayúsculas). import registra ese nombre junto al modelo instalado, y run, serve, upscale, inspect, remove y list lo usan; no hay un segundo nombre corto. Un modelo instalado antes de 0.6.3 conserva su nombre de directorio hasta que se ejecuta una vez neurobrix import org/Model para él (no se vuelve a descargar nada).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
Kokoro-82M habla inglés (léxico estadounidense); elija una voz inglesa, por ejemplo af_heart.
neurobrix hubExplora el registro (no hace falta iniciar sesión).
| Opción | Descripción |
|---|---|
--category, -c |
Filtrar por categoría (se convierte a mayúsculas por ti) |
--search, -s |
Buscar por texto |
--registry |
URL del registro (por defecto https://neurobrix.org; las versiones anteriores a 0.6.5 usan https://neurobrix.es, que sigue en servicio) |
--json |
Salida legible por máquina |
neurobrix hub --category IMAGE
Una categoría desconocida muestra Error: unknown category '<value>' (valid categories: ...) (la lista viene del registro) y sale con código 2. Los valores válidos están en Hub de modelos.
neurobrix import ORG/NAMEDescarga e instala un modelo.
| Opción | Descripción |
|---|---|
--registry |
URL del registro |
--force |
Reinstalar un modelo que ya está instalado |
--no-keep |
Borrar el .nbx descargado tras la extracción (por defecto se conserva en ~/.neurobrix/store/) |
--container FILE.nbx |
Instala desde un contenedor que la máquina ya tiene, verificado contra el sha256 que sirve el hub; no se descarga nada |
--accept-license |
Aceptar una licencia restringida sin preguntar |
--json |
Un evento JSON por línea |
neurobrix import hexgrad/Kokoro-82M
Qué ocurre, en orden: se busca el modelo (ERROR: Model 'org/name' not found on registry. si no existe), se comprueba la licencia, se solicita y se recibe la descarga, se comprueba el archivo y se extrae en ~/.neurobrix/cache/. La última línea es Installed org/name · run: <command>.
<file>.nbx.part. Ejecuta de nuevo el mismo comando y se reanuda con una petición HTTP Range.ERROR: not enough disk for this import). El uso máximo es aproximadamente el doble del tamaño del archivo salvo que pases --no-keep.org/name is already installed (--force re-downloads). y sale con 0, salvo con --force.Accept license terms? [yes/No]. En un shell no interactivo pasa --accept-license o define NBX_ACCEPT_LICENSE=1; de lo contrario: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (salida 1). La aceptación se recuerda localmente. Consulta Licencias.sha256sum) con el sha256 de la API. Un contenedor indicado con --container se verifica contra ese sha256 antes que nada.| Comando | Descripción |
|---|---|
neurobrix list [--store] [--json] |
Modelos instalados, por nombre (--store: también los archivos descargados) |
neurobrix remove MODEL [--store] [--all] [--json] |
Elimina un modelo. Por defecto elimina solo la copia extraída; --store el archivo, --all ambos |
neurobrix clean [--store] [--cache] [--all] [-y] |
Vacía el store y/o la caché. Sin ninguna de las tres opciones: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (salida 1) |
| Comando | Descripción |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
Resumen del motor, los modelos y el hardware |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
Mira dentro de un archivo .nbx o de un modelo instalado |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
Comprueba uno o varios archivos .nbx. Niveles (--level, -l): structure, schema, coherence (predeterminado), deep. Salida 0 si todos los archivos son válidos, 1 si no |
neurobrix doctor [--json] |
Comprueba la instalación: PATH, el motor Triton (versiones de nbxtensor y Triton), PyTorch y su versión CUDA (opcional), las GPU que ve el proceso |
doctor sale con 0 y "No blocking problem found", o con 1 y los problemas con la corrección de cada uno (1 también cuando ningún motor puede ejecutarse). PyTorch engine: not installed (optional; ...) solo es un problema bloqueante si el motor Triton tampoco puede ejecutarse; el wheel de PyTorch que sugiere depende de la GPU (una V100 recibe cu126). Con --json imprime {"schema", "engine", "ok": bool, "problems": [...]}. En Apple Silicon informa de la GPU de Apple (Metal). Consulta Instalar según el hardware.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
--model solo puede omitirse cuando hay un daemon de servicio en marcha (Error: --model is required when no daemon is running.). Mientras un daemon sirve otro modelo, una ejecución en frío se rechaza (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.); con el mismo modelo, la ejecución usa el daemon en caliente.
Opciones comunes
| Opción | Descripción |
|---|---|
--hardware |
Perfil de hardware (autodetectado si se omite) |
--explain-plan |
Muestra el plan de ubicación y sale sin cargar nada |
--json |
Con --explain-plan: el plan como un único registro JSON |
--prompt |
Prompt de texto |
--output |
Archivo de salida. Por defecto output_<model>.<ext>; la extensión debe coincidir con la familia del modelo |
--seed, --set KEY=VALUE |
Semilla; sobrescribe un valor por defecto del modelo (repetible) |
--certified-only |
Equivale a NBX_AUTOTUNE_CERTIFIED_ONLY=1 (también en calibrate y drift) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
Modo de ejecución (como máximo uno; el predeterminado es --compiled si PyTorch está instalado, --triton si no): --compiled, --sequential, --triton, --triton-sequential. Pasar más de uno: Error: only one execution mode flag can be passed at a time (salida 1).
Por familia
| Opción | Usada por |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
Modelos de lenguaje |
--turns FILE |
Modelos de lenguaje: una lista JSON de mensajes del usuario reproducida como una sola sesión de chat, turno tras turno |
--steps, --cfg, --height, --width |
Generación de imagen y vídeo |
--input-image, --mask-image |
Imagen a imagen, inpainting, visión-lenguaje |
--num-frames, --fps, --input-video, --video |
Vídeo |
--audio |
Voz a texto, modelos de lenguaje de audio |
--speaker |
Texto a voz |
--reference-audio, --reference-image |
No conectados en esta versión: se rechazan por su nombre |
Un primer comando para cada familia
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
Las entradas obligatorias dependen de la familia. Si falta una, la ejecución se detiene con ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line., y una extensión de salida incorrecta con ZERO FALLBACK: output extension '.x' incompatible with family .... Los modelos de visión-lenguaje necesitan --prompt y --input-image; los modelos de lenguaje de audio necesitan --audio y --prompt; los modelos multimodales necesitan --mode text|image|audio.
Dónde escribe la transcripción la conversión de voz a texto cuando se omite --output aún no está documentado.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| Opción | Descripción |
|---|---|
--model |
Obligatoria |
--input, --input-image |
Obligatoria, la imagen de origen |
--output |
Obligatoria, una ruta PNG |
--mode |
compiled (predeterminado), sequential, triton, triton-sequential |
--hardware |
Perfil de hardware |
Una entrada que falta muestra Error: input image not found: <path> (salida 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| Comando | Opciones |
|---|---|
serve |
--model (obligatorio), --hardware, --timeout (segundos de inactividad, 1800 por defecto), --foreground, --http (sirve también la API HTTP compatible con OpenAI, por defecto 127.0.0.1:8765), --http-host, --http-port, --api-key-file (obligatorio para una dirección distinta de loopback), --ready-fd / --ready-file (para un programa que lanza el daemon: dónde escribir el registro JSON de una línea que indica que está listo), opciones de modo de ejecución |
chat |
--max-tokens, --temperature, --repetition-penalty. En el chat: /new, /context, /status, /quit |
stop |
ninguna; pide al daemon que termine, lo finaliza si es necesario y limpia los archivos obsoletos |
Si ya existe un daemon, serve muestra Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it y sale con 1. Una tarea a la vez. Más en la Guía de servicio y en Serving and chat.
Siguiente: Configuración
© 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Ü