Struct AresConfig 

pub struct AresConfig {

    pub server: ServerConfig,
    pub auth: AuthConfig,
    pub database: DatabaseConfig,
    pub nvidia: Option<NvidiaConfig>,
    pub providers: HashMap<String, ProviderConfig>,
    pub models: HashMap<String, ModelConfig>,
    pub tools: HashMap<String, ToolConfig>,
    pub agents: HashMap<String, AgentConfig>,
    pub workflows: HashMap<String, WorkflowConfig>,
    pub rag: RagConfig,
    pub billing: BillingConfig,
    pub skills: Option<SkillsTomlConfig>,
    pub config: DynamicConfigPaths,
}

Root configuration structure loaded from ares.toml

Fields

server: ServerConfig

HTTP server configuration (host, port, log level).

auth: AuthConfig

Authentication configuration (JWT secrets, expiry times).

database: DatabaseConfig

Database configuration (Turso/SQLite, Qdrant).

nvidia: Option<NvidiaConfig>

NVIDIA provider + catalog configuration. When present, the runtime fetches the model catalog from models_url (default: NVIDIA NIM) and exposes it through the provider registry. If absent, the registry uses built-in defaults.

providers: HashMap<String, ProviderConfig>

Named LLM provider configurations

models: HashMap<String, ModelConfig>

Named model configurations that reference providers NOTE: These are being migrated to TOON files in config/models/

tools: HashMap<String, ToolConfig>

Tool configurations NOTE: These are being migrated to TOON files in config/tools/

agents: HashMap<String, AgentConfig>

Agent configurations NOTE: These are being migrated to TOON files in config/agents/

workflows: HashMap<String, WorkflowConfig>

Workflow configurations NOTE: These are being migrated to TOON files in config/workflows/

rag: RagConfig

RAG configuration

billing: BillingConfig

Billing and cost-estimation configuration

skills: Option<SkillsTomlConfig>

Skills configuration (SKILL.md discovery directories)

config: DynamicConfigPaths

Dynamic configuration paths (TOON files)

Implementations

impl AresConfig

pub fn load<P: AsRef<Path>>(path: P) -> Result<Self, ConfigError>

Load configuration from a TOML file

Panics

Panics if the configuration file doesn’t exist or is invalid. This is intentional - the server cannot run without a valid config.

pub fn load_unchecked<P: AsRef<Path>>(path: P) -> Result<Self, ConfigError>

Load configuration from a TOML file without validation.

This is useful for CLI commands that only need to inspect the configuration without actually running the server (e.g., ares-server config). Environment variables are not checked.

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

Validate the configuration for internal consistency and env var availability

pub fn validate_with_warnings(&self) -> Result<Vec<ConfigWarning>, ConfigError>

Validate configuration with warnings for unused items

Returns Ok with warnings, or Err if validation fails

pub fn resolve_env(&self, env_name: &str) -> Option<String>

Get a resolved value from an env var reference

pub fn mcp_client_names(&self) -> Vec<String>

Get the JWT secret from the environment

Errors

Returns an error if:

• The environment variable is not set
• The secret is shorter than 32 characters (256 bits)

Get names of configured MCP clients (from mcps directory .toon files). Used by validation to allow MCP bridge tool names in agent configs.

pub fn jwt_secret(&self) -> Result<String, ConfigError>

pub fn api_key(&self) -> Result<String, ConfigError>

Get the API key from the environment

pub fn get_provider(&self, name: &str) -> Option<&ProviderConfig>

Get provider by name

pub fn get_model(&self, name: &str) -> Option<&ModelConfig>

Get model by name

pub fn get_agent(&self, name: &str) -> Option<&AgentConfig>

Get agent config by name

pub fn get_tool(&self, name: &str) -> Option<&ToolConfig>

Get tool config by name

pub fn get_workflow(&self, name: &str) -> Option<&WorkflowConfig>

Get workflow config by name

pub fn enabled_tools(&self) -> Vec<&str>

Get all enabled tools

pub fn agent_tools(&self, agent_name: &str) -> Vec<&str>

Get all tools for an agent

Trait Implementations

impl Clone for AresConfig

fn clone(&self) -> AresConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AresConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AresConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AresConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.