Settings
Settings live in ~/.axom/axom.yaml. Change them with /config in the terminal, the Customize screen in the browser UI, or by editing the file. Most apply after axom restart; job settings apply immediately.
Model
| Setting | Key | Default | |
|---|---|---|---|
| Context window | max_model_len | 32768 | Tokens the model sees per turn: 4K–64K. Bigger costs memory and slows long turns. |
| Leaf strength | leaf_scale | 1.0 | How strongly the leaf steers the base model (0.1–1.5). |
Answers
| Setting | Key | Default | |
|---|---|---|---|
| Temperature | gen_temperature | 0.3 | Lower is steadier; higher is more varied. |
| Max steps per turn | react_max_steps | 100 | Think-act steps before a turn is cut off. |
| Always answer | react_forced_resolution | on | When a turn ends without an answer, say what happened. |
| Stream while writing | stream_deltas | on | Show the answer as it's generated. |
| Today's date | inject_date | on | Put the date in every prompt. |
| Voice pass | voice_pass | off | off · auto · on. Rewrite each answer once in your configured voice. |
Memory
| Setting | Key | Default | |
|---|---|---|---|
| Recent exchanges | recency_exchanges | 200 | How many of this session's exchanges ride along; older ones stay recallable. |
| Recall threshold | memory_signal_threshold | 0.72 | How relevant a memory must be to be recalled. |
| Tidy after idle | housekeeping_idle | 5m | 2m · 5m · 15m · 1h · off |
Tools
| Setting | Key | Default | |
|---|---|---|---|
| Parallel tool calls | fanout_batch | on | Let one step run several independent tool calls at once. Capped at 12 a step. |
| Tool output budget | tool_max_output | 6000 | Characters of a tool result the model sees. |
| Max parallel tools | fanout_max_agents | 8 | Most tool calls run in parallel from one step (1–16). |
| Digest pages | fanout_digest | overflow | off · overflow · always. Digest pages that don't fit the window. |
Jobs
| Setting | Key | Default | |
|---|---|---|---|
| Turn budget | job_max_turns | 12 | |
| Time budget | job_max_minutes | 30 | Minutes. |
| Watch interval | job_watch_interval | 300 | Seconds between checks when Axom doesn't choose its own wait. |
Runtime
| Setting | Key | Default | |
|---|---|---|---|
| Listen on | serve_host | 127.0.0.1 | 0.0.0.0 makes the browser UI reachable from other machines. |
| Unload after idle | idle_timeout | 30m | Free the GPU after this long idle: 10m … 6h, or off. |
| Terminal screen | ui | full | full or plain. |
| Speculative decoding | speculative | lookup | Draft from text already in context, faster on rewrites and quotes. |
In axom.yaml only
Not in the settings screen yet. Edit ~/.axom/axom.yaml and run axom restart.
| Key | Default | |
|---|---|---|
fanout_latent | off | The Latent Swarm: off · overflow · always. Local chassis only. |
engine_sessions | 1 | Sessions that run at the same time on one loaded model, each in its own stream, decoded together by the scheduler. |
Secrets
API keys go in ~/.axom/.env (for example BRAVE_API_KEY), never in axom.yaml.
Environment
| Variable | |
|---|---|
AXOM_HOME | The Axom home folder (default ~/.axom) |
AXOM_UI=plain | Plain terminal screen |
AXOM_CTX_CAP | Lowers the context window below the setting (never raises it) |
AXOM_FANOUT_LATENT | Overrides fanout_latent |