Ucotron Config

Configuration system for the Ucotron cognitive memory framework.

Provides TOML-based configuration parsing and validation for the server, storage backends, model pipelines, consolidation settings, namespaces, and auth.

Configuration Schema

The configuration file (ucotron.toml) supports the following sections:

• [server] — HTTP server settings (host, port, workers, log_level)
• [storage] — Storage backend selection and settings
• [models] — Embedding, NER, and LLM model configuration
• [consolidation] — Background consolidation worker settings
• [namespaces] — Multi-tenancy namespace configuration
• [auth] — Authentication settings (API key, JWT)
• [mcp] — MCP (Model Context Protocol) server settings
• [telemetry] — OpenTelemetry tracing and metrics export

Environment Variable Overrides

Every config field can be overridden via environment variables using the UCOTRON_ prefix and _ as section separator:

• UCOTRON_SERVER_HOST → server.host
• UCOTRON_SERVER_PORT → server.port
• UCOTRON_SERVER_WORKERS → server.workers
• UCOTRON_SERVER_LOG_LEVEL → server.log_level
• UCOTRON_SERVER_LOG_FORMAT → server.log_format
• UCOTRON_STORAGE_MODE → storage.mode
• UCOTRON_MODELS_DIR → models.models_dir
• UCOTRON_CONSOLIDATION_TRIGGER_INTERVAL → consolidation.trigger_interval
• UCOTRON_AUTH_API_KEY → auth.api_key
• etc.