Repository navigation
stabbur 0.10.2
stabbur init now leaves you with a project that works, rather than one that needs
a scavenger hunt first.
A new project comes with a voice
stabbur init <dir> downloads a package into the project's own library, not just the
chat model: Kokoro (the lightweight in-chat voice) and VoxCPM2 (the one worth
listening to) come with it. A Voice project adds Whisper, so the mic half of
"mic dictation in, spoken replies out" actually exists — the kind used to change the
system prompt and nothing else.
That is a few GB more per project, deliberately. --no-voices skips them for a
text-only assistant.
The model list leads with gemma-4-12B QAT, marked as the recommendation. It was
ordered by size, which made the 3B kept around for testing the default pick.
The wizard no longer asks which Kokoro voice should speak replies. Which voice speaks
is a click in the UI, not a property of the assistant; the manifest still carries a
default so a fresh project can speak immediately.
A moved project can speak
Kokoro's assets were written to the machine library, so a project carried to another
machine had nothing to synthesize with — the one thing a self-contained project is
supposed to survive. They now go to the library in play, which inside a project is the
project's own store.
VoxCPM2 has a house voice
It ships no named voices, unlike Kokoro's 54, so an unadorned request invented a new
speaker every time. The registry now pins a description and the seed that reproduces
it — chosen by ear — and that is what stabbur voice speak --model voxcpm2,
/v1/audio/speech and the chat Listen button use when nothing else is asked for.
--instruct and --seed still override it.
The pair holds only for the installed MLX version: an upgrade re-maps seeds to voices,
so a voice you liked may not survive one.
If you are upgrading
Nothing changes for an existing project or library — this is all in what init builds
and how a voice model with no presets behaves by default.
uv tool upgrade stabbur