Configuration

Every setting, generated from the BaseSettings classes. Set them as environment variables (upper-case) or in a .env file.

Server

Variable	Type	Default	Description
DB_PATH	str	'artel.db'	SQLite database path.
HOST	str	'0.0.0.0'	Bind address.
PORT	int	8000	HTTP port for the REST API, UI, and MCP endpoint.
RELOAD	bool	False	Auto-reload on code change (development only).
AGENT_KEYS	str	—	agent-id:api-key pairs, comma-separated. An optional :proj1;proj2 suffix scopes an agent to projects.
REGISTRATION_KEY	str	—	Shared key required by /agents/self-register. Unset disables open registration.
UI_PASSWORD	str	—	Password for the dashboard.
UI_AGENT_ID	str	'artel-ui'	Agent identity the dashboard acts as.
UI_DEFAULT_THEME	str	'gruvbox'	Default dashboard theme.
VIEWER_AGENT_ID	str	'sandbox-free-user'	Read-only agent used by public sandbox deployments.
DEMO_MODE	bool	False	Relaxes limits for a public demo instance.
ARCHIVIST_AGENT_ID	str	'archivist'	Agent id the archivist authenticates as.
PUBLIC_URL	str	—	Externally reachable base URL, used in OAuth metadata and onboarding.
MCP_URL	str	—	Override for the MCP URL advertised to clients.
JWT_TTL	int	2592000	OAuth token lifetime, in seconds.
MDNS_ENABLED	bool	True	Announce this instance on the LAN via mDNS.
GOSSIP_ENABLED	bool	True	Exchange peer lists with meshed instances.
RECALL_BANDIT_ENABLED	bool	False	Enable the contextual bandit for recall ranking. Off means observe-only.
RECALL_REINFORCE_GAIN	float	0.2	How strongly a retrieval reinforces an entry's confidence.
REGRET_THRESHOLD	float	0.7	Confidence below which reading an entry is recorded as a decay-regret event — the decay controller's sensor.
BLUEPRINT_REPO_ROOT	str	—	Undocumented — add it to SETTING_NOTES in scripts/gen_docs.py.

MCP adapter

Variable	Type	Default	Description
ARTEL_URL	str	'http://localhost:8000'	Base URL of the Artel server to connect to.
AGENT_KEYS	str	—	agent-id:api-key pairs, comma-separated. An optional :proj1;proj2 suffix scopes an agent to projects.
MCP_AGENT_ID	str	'mcp'	Agent identity for the MCP adapter.
MCP_AGENT_KEY	str	—	API key for the MCP adapter.
MCP_REGISTRATION_KEY	str	—	Registration key used when self-registering.
MCP_TRANSPORT	str	'stdio'	stdio or sse.
MCP_HOST	str	'0.0.0.0'	Bind address for the standalone MCP server.
MCP_PORT	int	8001	Port for the standalone MCP server.
MCP_PROJECT	str	—	Default project for memory and task calls.

Archivist

Variable	Type	Default	Description
ARTEL_URL	str	'http://localhost:8000'	Base URL of the Artel server to connect to.
ARCHIVIST_ID	str	'archivist'	Agent id the archivist runs as.
AGENT_KEYS	str	—	agent-id:api-key pairs, comma-separated. An optional :proj1;proj2 suffix scopes an agent to projects.
ANTHROPIC_API_KEY	str	—	Anthropic API key for archivist reasoning.
ARCHIVIST_PROVIDER	str	'anthropic'	anthropic, openai, or claude-sdk.
ARCHIVIST_MODEL	str	—	Model override. Empty uses the provider default.
ARCHIVIST_API_KEY	str	—	Overrides the provider-specific key.
ARCHIVIST_BASE_URL	str	—	Custom base URL for OpenAI-compatible providers.
SYNTHESIS_INTERVAL	int	3600	Seconds between archivist cycles.
LEASE_TTL_SECONDS	int	120	Curator lease lifetime. Only the lease holder runs passes.
LEASE_RENEW_SECONDS	int	40	How often the lease is renewed.
CONFLICT_THRESHOLD	float	0.92	Similarity above which two memories are treated as conflicting.
DIRECTIVE_CONFLICT_THRESHOLD	float	0.85	Similarity threshold for conflicting directives.
DECAY_RATE	float	0.9	Per-cycle confidence multiplier for unread memory.
DECAY_FLOOR	float	0.05	Confidence below which an entry is eligible for deletion.
DECAY_WINDOW_DAYS	int	7	Age before decay begins to apply.
PROMOTION_MEMORY_MIN_VERSION	int	3	Edits required before a memory can be promoted to a doc.
PROMOTION_STABILITY_DAYS	int	7	How long an entry must be stable before promotion.
PROMOTION_MIN_CONFIDENCE	float	0.6	Minimum confidence for promotion.
PROMOTION_DISTINCT_READERS	int	2	Distinct readers required before promotion.
CONTROL_DECAY_ENABLED	bool	True	Enable the PI controller that tunes the decay rate.
CONTROL_DECAY_KP	float	0.01	Proportional gain.
CONTROL_DECAY_KI	float	0.02	Integral gain.
CONTROL_DECAY_REGRET_SETPOINT	float	0.0	Target regret the controller drives toward.
CONTROL_DECAY_MIN	float	0.6	Lower bound on the controlled decay rate.
CONTROL_DECAY_MAX	float	0.99	Upper bound on the controlled decay rate.
CONTROL_DECAY_DEADBAND	float	0.5	Error band inside which the controller does nothing.
CONTROL_DECAY_LEAK	float	0.1	Integral leak, preventing windup.