neurobrix 0.6.15 ile doğrulandı (v0.6.15 etiketindeki komut satırı ayrıştırıcısı; üretilmiş başvurusu docs/reference/cli.md). Yetkili liste için herhangi bir komutu --help ile çalıştırın.
neurobrix --version # NeuroBrix v0.6.15
Bir alt komut zorunludur. Komutlar: run, serve, chat, stop, upscale, hub, import, list, remove, clean, info, inspect, validate, doctor.
Geliştirici komutları calibrate, autotune, drift ve coverage, neurobrix --help tarafından değil neurobrix --help -v tarafından listelenir. Her komut -v (motorun geliştirici satırları) ve -vv (ayrıca bir hatanın traceback'i) kabul eder.
| Kod | Anlamı |
|---|---|
| 0 | Başarı, --help ve --version (doctor: engelleyici sorun bulunmadı; validate: tüm dosyalar geçerli) |
| 1 | Error: ... olarak yazdırılan bir hata (bazı import mesajları: ERROR: ...); doctor: sorun bulundu; validate: bir dosya geçerli değil |
| 2 | Alt komut yok ya da bilinmeyen bir bayrak; hub: kayıt defteri isteği reddetti (örneğin bilinmeyen bir kategori) |
| 130 | Ctrl+C ile kesildi |
run, çalıştırmanın kendisinin sıfır olmayan durumuyla çıkar.
--json (info, inspect, list, remove, import, hub, doctor, validate üzerinde ve --explain-plan ile run üzerinde) stdout'a tek bir JSON kaydı, stderr'e okunabilir satırları yazdırır. import --json satır başına bir JSON olayı yayar.
Bir modelin tek bir adı vardır: hub adı org/Model (büyük/küçük harfe duyarlı). import bu adı kurulu modelin yanına kaydeder; run, serve, upscale, inspect, remove ve list onu kullanır; ikinci, kısa bir ad yoktur. 0.6.3'ten önce kurulmuş bir model, onun için bir kez neurobrix import org/Model çalıştırılana kadar dizin adını korur (hiçbir şey yeniden indirilmez).
neurobrix import hexgrad/Kokoro-82M
neurobrix run --model hexgrad/Kokoro-82M --prompt "Hello" --speaker af_heart --output hello.wav
Kokoro-82M İngilizce konuşur (Amerikan sözlüğü); af_heart gibi İngilizce bir ses seçin.
neurobrix hubKayıt defterine göz atın (oturum açmak gerekmez).
| Bayrak | Açıklama |
|---|---|
--category, -c |
Kategoriye göre filtrele (sizin için büyük harfe çevrilir) |
--search, -s |
Metne göre ara |
--registry |
Kayıt URL'si (varsayılan https://neurobrix.org; 0.6.5 öncesi sürümler hâlâ sunulan https://neurobrix.es adresine gider) |
--json |
Makine tarafından okunabilir çıktı |
neurobrix hub --category IMAGE
Bilinmeyen bir kategori Error: unknown category '<value>' (valid categories: ...) yazdırır (liste kayıttan gelir) ve 2 ile çıkar. Geçerli değerler Model Hub'ı sayfasındadır.
neurobrix import ORG/NAMEBir modeli indirip kurun.
| Bayrak | Açıklama |
|---|---|
--registry |
Kayıt defteri URL'si |
--force |
Zaten kurulu bir modeli yeniden kur |
--no-keep |
İndirilen .nbx dosyasını açma işleminden sonra sil (varsayılan olarak ~/.neurobrix/store/ içinde tutulur) |
--container FILE.nbx |
Makinenin zaten sahip olduğu bir kapsayıcıdan kurar, hub'ın sunduğu sha256'ya göre doğrulanır; hiçbir şey indirilmez |
--accept-license |
Kapılı bir lisansı istem göstermeden kabul et |
--json |
Satır başına bir JSON olayı |
neurobrix import hexgrad/Kokoro-82M
Sırasıyla ne olur: model aranır (yoksa ERROR: Model 'org/name' not found on registry.), lisans denetlenir, indirme istenir ve akışla alınır, arşiv denetlenir, ardından ~/.neurobrix/cache/ içine açılır. Son satır Installed org/name · run: <command> olur.
<file>.nbx.part dosyasına gider. Aynı komutu yeniden çalıştırın; bir HTTP Range isteğiyle sürer.ERROR: not enough disk for this import). --no-keep vermezseniz tepe kullanım arşiv boyutunun yaklaşık iki katıdır.org/name is already installed (--force re-downloads). yazdırır ve --force verilmedikçe 0 ile çıkar.Accept license terms? [yes/No] diye sorar. Etkileşimsiz bir kabukta --accept-license verin ya da NBX_ACCEPT_LICENSE=1 ayarlayın, aksi halde: ERROR: license '<id>' requires explicit acceptance: re-run with --accept-license (çıkış 1). Kabul yerel olarak hatırlanır. Lisanslar sayfasına bakın.sha256 ile kendiniz karşılaştırın (sha256sum). --container ile verilen bir kapsayıcı, her şeyden önce bu sha256'ya göre doğrulanır.| Komut | Açıklama |
|---|---|
neurobrix list [--store] [--json] |
Kurulu modeller, adlarıyla (--store: indirilen arşivler de) |
neurobrix remove MODEL [--store] [--all] [--json] |
Bir modeli kaldırır. Varsayılan olarak yalnızca açılmış kopyayı kaldırır; --store arşivi, --all ikisini |
neurobrix clean [--store] [--cache] [--all] [-y] |
Store'u ve/veya önbelleği boşaltır. Üç bayraktan hiçbiri yoksa: Error: say what to wipe: --store (the .nbx archives), --cache (the installed models) or --all (çıkış 1) |
| Komut | Açıklama |
|---|---|
neurobrix info [--models] [--hardware] [--system] [--json] |
Motor, model ve donanım özeti |
neurobrix inspect PATH_OR_MODEL [--topology] [--weights] [--json] |
Bir .nbx dosyasının ya da kurulu bir modelin içine bakın |
neurobrix validate NBX... [--level LEVEL] [--strict] [--json] [-v] |
Bir veya daha fazla .nbx dosyasını denetler. Düzeyler (--level, -l): structure, schema, coherence (varsayılan), deep. Tüm dosyalar geçerliyse çıkış 0, değilse 1 |
neurobrix doctor [--json] |
Kurulumu denetler: PATH, Triton motoru (nbxtensor ve Triton sürümleri), PyTorch ve CUDA derlemesi (isteğe bağlı), sürecin gördüğü GPU'lar |
doctor "No blocking problem found" ile 0, ya da sorunlar ve her birinin düzeltmesiyle 1 ile çıkar (hiçbir motor çalışamadığında da 1). PyTorch engine: not installed (optional; ...) yalnızca Triton motoru da çalışamıyorsa engelleyicidir; önerdiği PyTorch wheel'i GPU'ya bağlıdır (V100 için cu126). --json ile {"schema", "engine", "ok": bool, "problems": [...]} yazdırır. Apple Silicon'da Apple GPU'sunu (Metal) bildirir. Bkz. Donanıma göre kurulum.
neurobrix runneurobrix run --model <org/name> --prompt "..." [options]
--model yalnızca bir sunma daemon'ı çalışırken atlanabilir (Error: --model is required when no daemon is running.). Bir daemon başka bir modeli sunarken soğuk çalıştırma reddedilir (Error: a serving daemon is running (PID n) with another model, and NeuroBrix runs one task at a time.); aynı modelle çalıştırma sıcak daemon'ı kullanır.
Ortak seçenekler
| Bayrak | Açıklama |
|---|---|
--hardware |
Donanım profili (atlanırsa otomatik algılanır) |
--explain-plan |
Yerleşim planını yazdırır, ardından hiçbir şey yüklemeden çıkar |
--json |
--explain-plan ile: plan tek bir JSON kaydı olarak |
--prompt |
Metin istemi |
--output |
Çıktı dosyası. Varsayılan output_<model>.<ext>; uzantı model ailesiyle eşleşmelidir |
--seed, --set KEY=VALUE |
Tohum; bir model varsayılanını geçersiz kıl (yinelenebilir) |
--certified-only |
NBX_AUTOTUNE_CERTIFIED_ONLY=1 ile aynı (calibrate ve drift üzerinde de) |
--mode |
auto, text, chat, image, audio, video, t2i, img2img, inpainting, t2v, i2v, v2v |
Yürütme modu (en fazla biri; varsayılan, PyTorch kuruluysa --compiled, değilse --triton): --compiled, --sequential, --triton, --triton-sequential. Birden fazlasını vermek: Error: only one execution mode flag can be passed at a time (çıkış 1).
Aileye göre
| Bayrak | Kullanan |
|---|---|
--max-tokens, --temperature, --top-k, --top-p, --repetition-penalty, --system, --chat / --no-chat |
Dil modelleri |
--turns FILE |
Dil modelleri: tur tur, tek bir sohbet oturumu olarak oynatılan bir JSON kullanıcı mesajları listesi |
--steps, --cfg, --height, --width |
Görüntü ve video üretimi |
--input-image, --mask-image |
Görüntüden görüntüye, inpainting, görme-dil |
--num-frames, --fps, --input-video, --video |
Video |
--audio |
Konuşmadan metne, ses dil modelleri |
--speaker |
Metinden konuşmaya |
--reference-audio, --reference-image |
Bu sürümde bağlı değil: adıyla reddedilir |
Her aile için ilk komut
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
Gerekli girdiler aileye bağlıdır. Eksik olan, çalıştırmayı ZERO FALLBACK: family '<f>' requires <flag>. Provide it on the command line. iletisiyle, yanlış bir çıktı uzantısı ise ZERO FALLBACK: output extension '.x' incompatible with family ... iletisiyle durdurur. Görüntü-dil modelleri --prompt ve --input-image ister; ses dil modelleri --audio ve --prompt ister; multimodal modeller --mode text|image|audio ister.
--output atlandığında konuşmadan metne çıktısının transkriptini nereye yazdığı henüz belgelenmedi.
neurobrix upscaleneurobrix upscale --model <org/name> --input in.png --output out.png
| Bayrak | Açıklama |
|---|---|
--model |
Zorunlu |
--input, --input-image |
Zorunlu, kaynak görüntü |
--output |
Zorunlu, bir PNG yolu |
--mode |
compiled (varsayılan), sequential, triton, triton-sequential |
--hardware |
Donanım profili |
Eksik bir girdi Error: input image not found: <path> yazdırır (çıkış 1).
neurobrix serve --model <org/name> # load once
neurobrix run --prompt "..." # no --model needed
neurobrix chat # interactive, language models
neurobrix stop # shut it down
| Komut | Bayraklar |
|---|---|
serve |
--model (zorunlu), --hardware, --timeout (boşta saniye, varsayılan 1800), --foreground, --http (OpenAI uyumlu HTTP API'yi de sunar, varsayılan 127.0.0.1:8765), --http-host, --http-port, --api-key-file (loopback dışındaki bir adres için zorunlu), --ready-fd / --ready-file (daemon'ı başlatan bir program için: tek satırlık JSON hazır kaydının yazılacağı yer), yürütme modu bayrakları |
chat |
--max-tokens, --temperature, --repetition-penalty. Sohbette: /new, /context, /status, /quit |
stop |
yok; daemon'dan çıkmasını ister, gerekirse sonlandırır ve eski dosyaları temizler |
Bir daemon zaten varsa serve, Error: a daemon is already running (PID n): neurobrix chat talks to it, neurobrix stop ends it yazdırır ve 1 ile çıkar. Aynı anda bir görev. Ayrıntılar Sunma Kılavuzu ve Serving and chat sayfalarında.
Sonraki: Yapılandırma
© 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Ü