Configuration
Initialize, inspect, and validate configuration with:
mirmir config init
mirmir config show
mirmir config validate
The main file is ~/.config/mirmir/config.toml. Secrets are stored separately
with protected permissions and are never returned in clear text by the TUI,
web dashboard, CLI, or private gRPC API.
Runtime settings
| Key | Default | Meaning |
|---|---|---|
runtime.kv_block_size | automatic | Tokens stored in one K/V block. |
runtime.kv_blocks | automatic | Total block capacity. |
runtime.kv_cache_dtype | auto | Backend-resolved K/V storage type. |
runtime.max_batch_requests | automatic | Concurrent decode batch limit. |
runtime.max_batch_tokens | automatic | Scheduler token budget. |
runtime.vision_max_pixels | automatic | Hard cap on resized image area. |
runtime.vision_attention_budget_bytes | automatic | Vision attention workspace cap. |
runtime.vision_memory_percent | 80 | Memory available to automatic vision budgeting. |
Server settings
| Key | Default | Meaning |
|---|---|---|
server.http_bind | 127.0.0.1:8080 | HTTP listen address. |
server.allow_remote | false | Permits a non-loopback bind. |
server.web_enabled | false | Serves the embedded dashboard on /ui/. |
server.cors_origins | [] | Exact allowed browser origins. |
server.body_limit_bytes | 29360128 | Maximum request body. |
server.request_timeout_seconds | 300 | HTTP request timeout. |
server.max_concurrency | 16 | In-flight HTTP request limit. |
Most runtime and server settings require a restart. The UI identifies this per row.
Set and remove secrets
printf '%s' "$HF_TOKEN" | mirmir config set hugging_face.token
printf '%s' "$MIRMIR_HTTP_API_KEY" | mirmir config set server.api_key
mirmir config remove server.api_key
Environment values take precedence when present. MiRMiR recognizes HF_TOKEN
and MIRMIR_HTTP_API_KEY for these two secrets.