Struct BrainConfig 

pub struct BrainConfig {

    pub brain: GeneralConfig,
    pub storage: StorageConfig,
    pub llm: LlmConfig,
    pub embedding: EmbeddingConfig,
    pub memory: MemoryConfig,
    pub encryption: EncryptionConfig,
    pub security: SecurityConfig,
    pub actions: ActionsConfig,
    pub proactivity: ProactivityConfig,
    pub adapters: AdaptersConfig,
    pub access: AccessConfig,
    pub channel: ChannelIntelligenceConfig,
    pub agents: AgentsConfig,
    pub confirm: ConfirmConfig,
    pub identity: IdentityConfig,
    pub reflex: ReflexConfig,
    pub logging: LoggingConfig,
    pub learning: LearningConfig,
    pub observability: ObservabilityConfig,
    pub monitoring: MonitoringConfig,
}

Top-level Brain configuration.

Fields

brain: GeneralConfig

storage: StorageConfig

llm: LlmConfig

embedding: EmbeddingConfig

memory: MemoryConfig

encryption: EncryptionConfig

security: SecurityConfig

actions: ActionsConfig

proactivity: ProactivityConfig

adapters: AdaptersConfig

access: AccessConfig

channel: ChannelIntelligenceConfig

agents: AgentsConfig

confirm: ConfirmConfig

identity: IdentityConfig

Principal & identity configuration consumed by identity::ConfigIdentityStore. Default is empty — signals carry Principal = None and the identity gate is silently skipped.

reflex: ReflexConfig

Reactive signal sources. Each subsection drives one reflex type; default is empty/disabled across the board, so a fresh install spawns no reflex tasks. cmd_serve reads this to construct FsReflex / CronReflex / SysStateReflex and bridge their streams into the pipeline via signal::spawn_reflex.

logging: LoggingConfig

Logging policy — base level, per-subsystem overrides, output format, and daemon log-file rotation. Default is empty/info pretty with daily rotation; RUST_LOG still overrides the computed filter at runtime.

learning: LearningConfig

Learned self-model knobs — currently the capability-fitness loop that records per-tool success/failure and feeds it back into tool ranking and the SOUL capability digest. Default is on with a 30-day half-life.

observability: ObservabilityConfig

Runtime resource-observability knobs — the resource sampler’s cadence and the per-gauge ceilings that trip a ResourcePressure event. Default is a 30s sample with generous, fail-safe ceilings.

monitoring: MonitoringConfig

External-service health monitoring — a list of HTTP/TCP endpoints to probe on a cadence, alerting on up↔down transitions. Default is empty, so a fresh install probes nothing.

Implementations

impl BrainConfig

pub fn load() -> Result<Self, Error>

Load configuration from all sources.

Priority (highest wins):

1. Environment variables (BRAIN_LLM__MODEL=...)
2. User config (~/.brain/config.yaml)
3. Embedded defaults (compiled into binary)

pub fn load_from(config_path: Option<&Path>) -> Result<Self, Error>

Load configuration with an optional explicit config path.

pub fn data_dir(&self) -> PathBuf

Resolve the data directory path, expanding ~ to the home directory.

pub fn ensure_data_dirs(&self) -> Result<()>

Ensure the data directory and subdirectories exist.

pub fn sqlite_path(&self) -> PathBuf

Path to the SQLite database file.

pub fn ruvector_path(&self) -> PathBuf

Path to the RuVector directory.

pub fn models_path(&self) -> PathBuf

Path to the models directory.

pub fn is_initialized() -> bool

Check whether Brain has been initialized (data dir exists).

pub fn write_default_config(force: bool) -> Result<Option<(PathBuf, String)>>

Write the default config to ~/.brain/config.yaml.

Returns (config_path, generated_api_key), or None if the file already exists and force is false.

pub fn user_config_path() -> PathBuf

Path to user config file.

BRAIN_CONFIG env var overrides the default ~/.brain/config.yaml, useful for sandboxes, CI, and multi-config workflows.

pub fn default_config_content() -> &'static str

Get the embedded default config content.

pub fn validate(&self) -> Result<Vec<String>, String>

Validate configuration and return a list of warnings.

impl BrainConfig

pub fn migrate_user_config_if_needed() -> Result<Option<MigrationOutcome>>

Migrate the user config file at the default path forward to this binary’s version, if it is stamped older. Returns Ok(None) when there is nothing to do (no file, unparseable, or already current). Errors only on a failed backup or rewrite — a half-migrated file must never be left on disk.

Trait Implementations

impl Clone for BrainConfig

fn clone(&self) -> BrainConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BrainConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BrainConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BrainConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BrainConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.