Configuration & Storage

Data directory

Lattis keeps its state under the platform data directory:

Platform	Path
macOS	~/Library/Application Support/lattis
Linux	~/.local/share/lattis
Windows	%APPDATA%\lattis

Contents

Entry	What it is
models/	Downloaded GGUF models (one folder per model).
config.json	Theme, host/port, resident set.
custom_models.json	User-added models.
remote_auth.json	Cloud credentials (mode 0600 on Unix).
llama-router.ini	Generated preset for the llama-server child.
daemon.log	Daemon output when launched on login.

Network

• The API listens on 127.0.0.1:1234 by default. The host and port are configurable; the llama-server router child uses the next port up.
• The API is unauthenticated and assumes a loopback bind. Do not expose it on a public interface without your own authentication in front.

Environment variables

Variable	Effect
LATTIS_LLAMA_SERVER	Path to an existing llama-server binary (skips the vendored one).
LATTIS_SKIP_VENDOR	At build time, skip downloading llama-server; use one on PATH.
LATTIS_MLX_PYTHON	Path to a Python interpreter that can import mlx_lm (MLX engine).

Themes

Two hand-tuned Lattis themes plus every built-in iced theme (Dracula, Nord, Tokyo Night, Catppuccin, Gruvbox, Kanagawa, and more), switchable live from Settings.

If something isn’t behaving, see Troubleshooting.