Configuration and models
Seven settings, a model catalog you can extend, and the environment variables that override both.
The settings file
Settings live in config.json in the config directory. tacet config set refuses any key outside the known list, because a settings file that accepts arbitrary keys becomes a graveyard of typos that silently do nothing.
tacet config list
tacet config get model
tacet config set theme sage
tacet config unset seed
tacet config pathThe keys
| Key | Values |
|---|---|
| model | Default model folder for chat, for example qwen3-4b |
| engine | auto, candle or fake, when --engine is not given |
| theme | mono, night, sage, graphite, violet |
| thinking | Qwen thinking mode: auto (per-turn heuristic, the default), on, off |
| temperature | 0.0 to 2.0. The default of 0 is greedy and reproducible. |
| seed | Only meaningful above temperature 0 |
| update.check | on, off, or ask. Default is ask, once, inside the shell. |
All but update.check are shortcuts for a flag you could pass anyway. update.check is stored rather than assumed because it decides whether this program contacts a server on its own, and that is a question the user has to answer.
Environment variables
| Variable | Effect |
|---|---|
| TACET_HOME | The config directory. Ignored with a warning if it is not absolute. |
| TACET_MODEL | A GGUF file to load, skipping the catalog entirely |
| TACET_TOKENIZER | Only for a GGUF that carries no tokenizer inside it |
| TACET_SEARXNG | A search root for one session |
| TACET_MCP_CONFIG | An alternative mcp.json |
The model catalog
tacet models list shows what is on disk and which roots were searched. tacet models download <name> fetches a catalog entry over HTTPS, printing the address first and rejecting the file unless its sha256 matches the digest compiled into the binary. Your own entries go in packages.json beside config.json, and tacet package list shows what the binary knows about.
Where weights are looked for
- Linux and Unix:
~/models, or$XDG_DATA_HOME/tacet/models - macOS:
~/models, or~/Library/Application Support/Tacet/models - Windows:
%USERPROFILE%\models, or%LOCALAPPDATA%\Tacet\models TACET_MODELskips all of the above
Reproducibility
The default sampling is greedy with seed 0, which is the right default for a measurement and not always the right one for a retry. Raise temperature when you want a second path through the model, and set seed if you want that second path to be repeatable. A non-numeric value is ignored with a warning rather than obeyed.