Проверено на neurobrix 0.6.15 (парсер командной строки на теге v0.6.15, сгенерированный справочник которого — docs/reference/cli.md). Запустите любую команду с --help, чтобы увидеть авторитетный список.
neurobrix --version # NeuroBrix v0.6.15
Подкоманда обязательна. Команды: run, serve, chat, stop, upscale, hub, import, list, remove, clean, info, inspect, validate, doctor.
Команды разработчика calibrate, autotune, drift и coverage выводит neurobrix --help -v, а не neurobrix --help. Каждая команда принимает -v (строки разработчика движка) и -vv (дополнительно traceback ошибки).
| Код | Значение |
|---|---|
| 0 | Успех, --help и --version (doctor: блокирующих проблем нет; validate: все файлы корректны) |
| 1 | Ошибка, выводимая как Error: ... (некоторые сообщения import: ERROR: ...); doctor: найдены проблемы; validate: файл некорректен |
| 2 | Нет подкоманды или неизвестный флаг; hub: реестр отклонил запрос (например, неизвестная категория) |
| 130 | Прервано по Ctrl+C |
run завершается с ненулевым статусом самого запуска.
--json (в info, inspect, list, remove, import, hub, doctor, validate, а также в run с --explain-plan) выводит одну JSON-запись в stdout и читаемые строки в stderr. import --json выдаёт одно JSON-событие на строку.
У модели одно имя — её имя на хабе org/Model (с учётом регистра). import записывает это имя рядом с установленной моделью, а run, serve, upscale, inspect, remove и list его используют; второго, короткого имени нет. Модель, установленная до 0.6.3, сохраняет имя каталога, пока для неё один раз не будет выполнена neurobrix import org/Model (ничего заново не загружается).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
Kokoro-82M говорит по-английски (американский лексикон); выберите английский голос, например af_heart.
neurobrix hubПросмотр реестра (вход в систему не нужен).
| Флаг | Описание |
|---|---|
--category, -c |
Фильтр по категории (приводится к верхнему регистру за вас) |
--search, -s |
Текстовый поиск |
--registry |
URL реестра (по умолчанию https://neurobrix.org; версии до 0.6.5 обращаются к https://neurobrix.es, по-прежнему обслуживается) |
--json |
Машиночитаемый вывод |
neurobrix hub --category IMAGE
Неизвестная категория выводит Error: unknown category '<value>' (valid categories: ...) (список приходит из реестра) и завершается с кодом 2. Допустимые значения — в разделе Хаб моделей.
neurobrix import ORG/NAMEСкачать и установить модель.
| Флаг | Описание |
|---|---|
--registry |
URL реестра |
--force |
Переустановить уже установленную модель |
--no-keep |
Удалить скачанный .nbx после распаковки (по умолчанию он сохраняется в ~/.neurobrix/store/) |
--container FILE.nbx |
Устанавливает из контейнера, который уже есть на машине, с проверкой по sha256, который отдаёт хаб; ничего не загружается |
--accept-license |
Принять закрытую лицензию без запроса |
--json |
Одно JSON-событие на строку |
neurobrix import hexgrad/Kokoro-82M
Что происходит по порядку: модель ищется (ERROR: Model 'org/name' not found on registry., если её нет), проверяется лицензия, запрашивается и потоково принимается загрузка, проверяется архив, затем он распаковывается в ~/.neurobrix/cache/. Последняя строка — Installed org/name · run: <command>.
<file>.nbx.part. Запустите ту же команду снова, и загрузка продолжится запросом HTTP Range.ERROR: not enough disk for this import). Пиковое использование — около двойного размера архива, если не передан --no-keep.org/name is already installed (--force re-downloads). и завершается с 0, если не указан --force.Accept license terms? [yes/No]. В неинтерактивной оболочке передайте --accept-license или задайте NBX_ACCEPT_LICENSE=1, иначе: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (код 1). Согласие запоминается локально. См. Лицензии.sha256sum) с sha256 из API. Контейнер, указанный через --container, прежде всего проверяется по этому sha256.| Команда | Описание |
|---|---|
neurobrix list [--store] [--json] |
Установленные модели по именам (--store: также загруженные архивы) |
neurobrix remove MODEL [--store] [--all] [--json] |
Удалить модель. По умолчанию удаляется только распакованная копия; --store — архив, --all — обе |
neurobrix clean [--store] [--cache] [--all] [-y] |
Очищает store и/или кэш. Без любого из трёх флагов: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (выход 1) |
| Команда | Описание |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
Сводка по движку, моделям и оборудованию |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
Заглянуть внутрь файла .nbx или установленной модели |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
Проверяет один или несколько файлов .nbx. Уровни (--level, -l): structure, schema, coherence (по умолчанию), deep. Выход 0, если все файлы корректны, иначе 1 |
neurobrix doctor [--json] |
Проверяет установку: PATH, движок Triton (версии nbxtensor и Triton), PyTorch и его CUDA-сборку (необязательно), GPU, которые видит процесс |
doctor завершается с 0 и "No blocking problem found" или с 1, перечисляя проблемы и исправление для каждой (1 также тогда, когда не может работать ни один движок). PyTorch engine: not installed (optional; ...) блокирует, только если движок Triton тоже не может работать; предлагаемый wheel PyTorch зависит от GPU (для V100 — cu126). С --json выводит {"schema", "engine", "ok": bool, "problems": [...]}. На Apple Silicon сообщает о GPU Apple (Metal). См. Установка по оборудованию.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
--model можно опустить, только когда работает демон обслуживания (Error: --model is required when no daemon is running.). Пока демон обслуживает другую модель, холодный запуск отклоняется (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.); с той же моделью запуск использует тёплый демон.
Общие параметры
| Флаг | Описание |
|---|---|
--hardware |
Профиль оборудования (определяется автоматически, если опущен) |
--explain-plan |
Выводит план размещения и завершается, ничего не загружая |
--json |
С --explain-plan: план в виде одной JSON-записи |
--prompt |
Текстовый запрос |
--output |
Выходной файл. По умолчанию output_<model>.<ext>; расширение должно соответствовать семейству модели |
--seed, --set KEY=VALUE |
Начальное значение генератора случайных чисел; переопределить значение модели по умолчанию (можно повторять) |
--certified-only |
То же, что NBX_AUTOTUNE_CERTIFIED_ONLY=1 (также в calibrate и drift) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
Режим выполнения (не более одного; по умолчанию --compiled, если установлен PyTorch, иначе --triton): --compiled, --sequential, --triton, --triton-sequential. Передача нескольких: Error: only one execution mode flag can be passed at a time (выход 1).
По семействам
| Флаг | Используется |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
Языковыми моделями |
--turns FILE |
Языковые модели: JSON-список сообщений пользователя, проигрываемый как одна сессия чата, ход за ходом |
--steps, --cfg, --height, --width |
Генерацией изображений и видео |
--input-image, --mask-image |
Изображение в изображение, inpainting, модели «зрение — язык» |
--num-frames, --fps, --input-video, --video |
Видео |
--audio |
Распознавание речи, аудио-языковые модели |
--speaker |
Синтез речи |
--reference-audio, --reference-image |
В этой версии не подключены: отклоняются по имени |
Первая команда для каждого семейства
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
Обязательный ввод зависит от семейства. Отсутствующий останавливает запуск с ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line., а неверное расширение вывода — с ZERO FALLBACK: output extension '.x' incompatible with family .... Моделям «зрение–язык» нужны --prompt и --input-image; аудио-языковым моделям нужны --audio и --prompt; мультимодальным моделям нужен --mode text|image|audio.
Куда распознавание речи записывает расшифровку, если --output опущен, пока не задокументировано.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| Флаг | Описание |
|---|---|
--model |
Обязателен |
--input, --input-image |
Обязателен, исходное изображение |
--output |
Обязателен, путь к PNG |
--mode |
compiled (по умолчанию), sequential, triton, triton-sequential |
--hardware |
Профиль оборудования |
Отсутствующий вход выводит Error: input image not found: <path> (выход 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| Команда | Флаги |
|---|---|
serve |
--model (обязателен), --hardware, --timeout (секунды простоя, по умолчанию 1800), --foreground, --http (также обслуживает HTTP API, совместимый с OpenAI, по умолчанию 127.0.0.1:8765), --http-host, --http-port, --api-key-file (обязателен для адреса, отличного от loopback), --ready-fd / --ready-file (для программы, запускающей демон: куда записать однострочную JSON-запись о готовности), флаги режима выполнения |
chat |
--max-tokens, --temperature, --repetition-penalty. В чате: /new, /context, /status, /quit |
stop |
нет; просит демон завершиться, при необходимости принудительно завершает его и очищает устаревшие файлы |
Если демон уже есть, serve выводит Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it и завершается с 1. Одна задача за раз. Подробнее в Руководстве по обслуживанию и в Serving and chat.
Далее: Конфигурация
© 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Ü