neurobrix run gestiona todas las familias de modelos. Lo que debes pasar depende de la familia.
| Modo | Comandos | Ideal para |
|---|---|---|
| En caliente (recomendado) | neurobrix serve --model <name>, luego neurobrix run --prompt "..." |
Varias ejecuciones, uso interactivo |
| En frío | neurobrix run --model <name> --prompt "..." |
Ejecuciones puntuales, scripts |
Una ejecución en frío carga los pesos, ejecuta y descarga. Mientras un daemon sirve otro modelo, una ejecución en frío se rechaza con Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.; ejecuta contra el daemon en caliente. <name> abajo es el nombre único del modelo, org/Model. Consulta la Guía de servicio.
| Familia | Comando | Salida |
|---|---|---|
| LLM | neurobrix run --model <name> --prompt "..." |
.txt |
| Imagen | neurobrix run --model <name> --prompt "..." --output x.png |
.png |
| Vídeo | neurobrix run --model <name> --prompt "..." --output x.mp4 |
.mp4 |
| TTS | neurobrix run --model <name> --prompt "text" --output x.wav |
.wav |
| STT | neurobrix run --model <name> --audio f.wav |
texto; adónde va sin --output: aún no está documentado |
| Escalador | neurobrix upscale --model <name> --input in.png --output out.png |
.png |
| VLM | --prompt y --input-image, ambos obligatorios |
texto |
| LLM de audio | --audio y --prompt, ambos obligatorios |
texto |
| Multimodal | --prompt y --mode text, image o audio; el modo es obligatorio |
según el modo |
Si falta una entrada obligatoria, el motor se detiene con ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line. Una extensión de --output incorrecta se rechaza del mismo modo, indicando la esperada. Sin --output, el archivo se llama output_<model> más la extensión de la familia (el texto de --help sigue diciendo output.png).
| Opción | Se aplica a | Significado |
|---|---|---|
--prompt |
la mayoría de familias | Texto de entrada |
--steps, --cfg, --seed |
imagen, vídeo | Pasos de difusión, escala de guía, semilla aleatoria |
--height, --width |
imagen | Tamaño de salida |
--num-frames, --fps |
vídeo | Duración y frecuencia del clip |
--input-image |
imagen, vídeo, VLM, escalador | Imagen de entrada; en imagen selecciona img2img, en vídeo i2v |
--mask-image |
imagen | Máscara de inpainting; necesita --input-image |
--video |
vídeo | Clip de entrada, selecciona v2v |
--speaker |
TTS | Identificador de voz predefinida (--reference-audio no está conectado en esta versión: se rechaza por su nombre) |
--max-tokens, --temperature, --repetition-penalty, --top-k, --top-p |
LLM | Muestreo |
--system |
LLM | Prompt de sistema |
--chat / --no-chat |
LLM | Mutuamente excluyentes |
--mode |
todas | auto, text, chat, agent, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
--set KEY=VALUE |
todas | Sobrescribe un valor por defecto del modelo; repetible |
--hardware |
todas | Id del perfil de hardware |
--explain-plan |
todas | Muestra el plan de colocación |
--json |
todas | Con --explain-plan: el plan como un único registro JSON |
Los valores por defecto de pasos, guía y tamaño provienen del propio modelo. Los valores por defecto por familia de las opciones de muestreo, como la temperatura: aún no están documentados.
Imagen:
neurobrix run --model <name> --prompt "A cute robot in a garden" --steps 20 --seed 42 --cfg 5.0 --width 1024 --height 1024 --output robot.png
Resultado esperado: un PNG en robot.png.
Sobrescribir un valor por defecto:
neurobrix run --prompt "test" --set global.guidance_scale=7.5
Pasa como máximo uno en run o serve:
| Opción | Significado |
|---|---|
--compiled |
El motor PyTorch; el predeterminado donde PyTorch está instalado |
--sequential |
El motor PyTorch una operación cada vez, para depuración |
--triton |
El motor Triton (nbxtensor, sin PyTorch); el predeterminado donde PyTorch no está instalado |
--triton-sequential |
El motor Triton una operación cada vez, para depuración |
Más de uno da Error: only one execution mode flag can be passed at a time y código de salida 1.
Siguiente: Guía de servicio
© 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Ü
Código fuente de la documentación: GitLab