KNOBS.md 1014 B

Knobs

The agent has no entrypoint script. It reads these directly (agent/spark-agent.py). The compose file requires LOG_DIR (the host side of /logs), MENTAT_ROUTER_URL and ALLOWED_SOURCES in the node's .env.

variable default meaning
AGENT_LOG_DIR /logs log and snapshot directory, mounted read-only
MENTAT_ROUTER_URL (none) mentat-serve, e.g. http://router:6381; source of the model table
MENTAT_GROUP agent-<hostname> group the agent registers its MCP under
MENTAT_DAEMON 127.0.0.1:6379 local mentatd control address
ALLOWED_SOURCES 127.0.0.1 address prefixes let in; the router's host is always let in
LOAD_INTERVAL_S 5 how often the router, peers and engines are read
AGENT_PORT 8090 port peers are linked on when --port is not given
PY_SPY py-spy py-spy binary for engine_stacks
SPARK_MEMORY_PY /usr/local/bin/spark-memory.py helper behind memory_accounting