Repository navigation
blazr 0.1.0
blazr runs on boostr and numr, serves an OpenAI-, Anthropic- and
Ollama-compatible API, and adds speech behind the audio feature: TTS and
ASR routes, and the speak, transcribe and sound-review commands.
Prebuilt CPU binaries ship for Linux, macOS and Windows. The CUDA build
installs from crates.io.
Built on boostr 0.5, numr 0.10, splintr 0.21, voxr 0.2 and voxr-narrate 0.2.
Minimum Rust: 1.95.
Added
- Commands —
serve,generate,run(REPL),chat,info,list,
pull,bench,ps,convert(through compressr) andcompletions.
swarmanddisaggrun distributed inference behind thedistributed
feature. - Narration commands (
audio)blazr speakturns a script into a voiceover WAV with Kokoro,
VoxCPM2, a VITS (MMS-TTS) model, or any TTS command. It hears every
phrase back with Whisper and reports the phrases that do not match.blazr transcribewrites word timings from a local Whisper model: one
words file per narration, and the video timeline from a manifest.blazr sound-reviewchecks rendered sound effects for sharpness, hiss,
tail and true peak, and ranks variants against their text with CLAP.- Exit codes: 0 done, 1 a problem remains or the run failed, 2 a bad
input, 3 aspeak --modelblazr does not run. - The commands accept the motion-video skill's global flags and ignore the
ones they do not read, so the skill calls blazr with its own arguments.
- Model download on first use — a Whisper, Kokoro, Kokoro G2P, VoxCPM2,
VITS or CLAP model missing from disk downloads once from the Hugging Face
hub, in hub layout. Only the files the loader reads are fetched.
HF_HUB_OFFLINE=1turns downloads off. - API routes —
/v1/completions,/v1/chat/completions,
/v1/embeddings,/v1/responses,/v1/messagesand
/v1/messages/count_tokens,/v1/infill,/rerankand/v1/rerank,
/tokenize,/detokenize,/apply-template,/v1/modelsand
/v1/models/{id},/api/slots,/v1/lora,/metrics,/health, and the
Ollama-compatible/api/tags,/api/show,/api/ps,/api/delete,
/api/copyand/api/pull. - Audio routes (
audio)POST /v1/audio/speechsynthesizes with Kokoro, VoxCPM2 or VITS, as
wav,pcmorf32."stream": truestreams the samples.POST /v1/audio/transcriptionsand/v1/audio/translationsrun
Whisper.timestamp_granularities[]=wordadds word timestamps to
verbose_json.GET /v1/audio/voiceslists a TTS model's voices.--voice-diris
searched before the TTS model directory'svoices/.serveflags:--asr-model,--tts-model,--voice-dir, and the
VoxCPM2 batching flags--tts-max-batch,--tts-batch-window-ms,
--tts-no-continuous-batchingand--tts-continuous-capacity.- A VoxCPM2 model directory's
adapters/<one>.safetensorsfolds a LoRA
adapter into the weights at load. A lone VoxCPM2 GGUF loads without
config.json.
- Chat — the model's own Jinja chat template renders every prompt, with
built-in templates as the fallback. Tool calling, a reasoning split
(reasoning_content), grammar and JSON-schema constrained output, logit
bias andncompletions. - Images —
qwen35models with a Qwen3-VL--mmprojtake images on the
chat, Responses and Messages routes. - Batching —
qwen35hybrid GDN/attention models decode in batched
lanes, with chunked prefill interleaved into occupied lanes. Other models
with paged attention decode in a continuous batch. - Engine — CUDA graph decode reused across requests, speculative
decoding, LoRA, MoE offload, prefix caching, tensor parallelism (nccl)
and data parallelism. - Models — LLaMA, Mistral, Mamba2/3, DeepSeek MLA+MoE, hybrid
Mamba+attention andqwen35(Bonsai-2) architectures. Weights load from
SafeTensors and GGUF. LLaMA and Mistral also load from AWQ and GPTQ. - Server — API keys (
--api-key,--api-key-file,BLAZR_API_KEY),
HTTPS (--tls-cert,--tls-key), Prometheus metrics, inference slots,
per-requestkeep_alivewith model eviction, an in-flight token budget,
and a hot-reloaded user config at~/.blazr/config.yaml. - TLS — rustls with the ring provider. Hugging Face downloads go over
rustls, so the Linux binary needs no system OpenSSL. - Releases — prebuilt archives for
linux-x64,linux-arm64,
macos-arm64andwindows-x64, withSHA256SUMS. Each carriesNOTICE
(the Llama attribution and the notices for ported code),LICENSE-LLAMA
andTHIRD-PARTY-LICENSES.txt, the licence of every compiled-in crate.