Repository navigation
Releases
Releases · caldrix-ai/caldrix
caldrix v0.2.0
Added
caldrix poolandcaldrix pool --protocol-version: a daemon on a Unix socket that holds loaded models
and serves them to local clients over a framed protocol (caldrix pool).
It has run on the CPU lane, and on Metal on one Apple M1 Max at max context 2048 and one request at
8192; it has not been run on AMD GPUs.caldrix models: search, inspect and list models from the downloaded model index
(caldrix models).ollama:<name>[:<tag>]model references, downloaded from the Ollama registry
(Ollama tags).- Ollama Q4_K_M and Q8_0 tags, read and sized before any download and run at an f32 plan; an explicit
--dtype bf16and--weight-budgetare refused for them by name
(Ollama tags). On Metal, on one Apple M1 Max, three small
tags and an 8 B Q4_K_M tag were token-exact in f32 andcaldrix runof the 8 B tag completed. On the CPU
lane atx86-64-v3, four small tags were token-exact in f32 at the desk on one machine, a desk reading,
not a run. On AMD GPUs thehiplane compiles them and holds a quantized model to one request at a
time (--max-batchlowers from 8 to 1 with a startup line, and an explicit--max-batch 8is refused
by name); nothing quantized has run on an AMD device. - Sampling for
caldrix run:--temperature,--top-k,--top-p,--min-p,--repetition-penaltyand
--seed, and the chat's commands for them (Sampling). - Sampling for
caldrix serve: the same six flags set the server's defaults, and/v1requests accept
temperature,top_p,top_k,min_p,repetition_penaltyandseedper request, where v0.1.2
refused a non-neutraltemperature,top_p,top_k,min_porrepetition_penaltywith a400
naming the field and acceptedseedwhile decoding greedily
(Sampling). On the AMD lane with batching on (--max-batch 8,
its default there) the GPU picks each sampled token, so the same seed can give a different reply than a
pick on the CPU;--sampler hostmoves that pick back to the CPU. Every other lane, and
--max-batch 1, always picks on the CPU. --system TEXT|@FILEto set a system prompt,--rawto send the prompt as plain text, and--jsonfor
caldrix run's output as JSON.- The
qwen3-30b-a3balias and theQwen3MoeForCausalLMarchitecture, verified by its token gates on
one AMD MI300X with every expert resident, on one Apple M1 Max streamed under a 56 GiB
--weight-budget, and on the CPU lane streamed under a 20 GiB budget;--max-batchabove 1 is refused
for it (Aliases). CALDRIX_OFFLINE, likeHF_HUB_OFFLINEbut covering every network edge caldrix has: the Hub, the model
index and the Ollama registry (Environment).MistralForCausalLMis accepted by the import; it is not verified on hardware.- Llama 3 rope scaling, applied from a
config.jsonand from a GGUF'srope_freqs.weight.
Changed
- Generation is no longer greedy-only: it is greedy unless a sampling flag asks otherwise.
- The Metal prefill and decode attention are tiled over the context. On one Apple M1 Max a 6002-token
prompt ran at max context 7680, and max context 8192 loaded and ran. caldrix runopens the chat screen on a terminal;--plainkeeps the line-by-line chat.
Known limitations
- Quantized tags have not been run on AMD GPUs; on the CPU lane they have only a desk reading, not a run;
quantized safetensors checkpoints are refused. caldrix poolhas not been run on AMD GPUs.- NVIDIA GPUs are not supported.
caldrix v0.1.2
Added
- The
smollm2-instructalias (HuggingFaceTB/SmolLM2-135M-Instruct), a SmolLM2 with a chat template
forcaldrix run. Its tokens are verified on the CPU lane (x86-64-v3) on a plain-text prompt; it is
not verified on Metal or AMD GPUs, and no check covers the chat template.
Changed
caldrix runwith a model that has no chat template (such assmollm2) stops each reply at 256
tokens unless--max-tokensis given; before, a base model could run until the context filled.
caldrix v0.1.1
Added
- A release archive for macOS on Apple silicon (
aarch64-darwin, macOS 14.0 or newer), installed with
the samecurl -fsSL https://caldrix.ai/install.sh | sh. - The installer refuses a Mac below macOS 14.0 by name, before downloading anything.
caldrix v0.1.0
The first release.
Added
caldrix run <model>: chat with a model in the terminal, or answer one prompt with-p.caldrix serve <model>: an OpenAI-compatible HTTP server, on port 8425 by default, with
POST /v1/chat/completions(streaming or not),POST /v1/completionsandGET /v1/models.caldrix doctor: reports which lanes this machine can run:hip(AMD GPUs through ROCm),
metal(Apple silicon) andcpu.- Models by alias (
smollm2,llama-8b,qwen3-0.6b), by Hugging Face name
(owner/name[@revision]) or from a local directory, for the Llama, Qwen2 and Qwen3 architectures. - A release archive for Linux on x86_64 (glibc 2.38 or newer), installed with
curl -fsSL https://caldrix.ai/install.sh | sh.
Known limitations
- There is no macOS archive in this release yet; it will be added to this release when it is built.
- Generation is greedy: sampling parameters are refused.
- NVIDIA GPUs, mixture-of-experts models and quantized checkpoints are not supported.