Skip to main content

foundry-agent-config

Status: Available Version Python

YAML configuration loader with environment-variable overrides for Pydantic models. One function, load_config, reads a YAML file, merges env-var overrides (double-underscore nesting), and validates the result against a user-supplied BaseModel.

Install​

uv add foundry-agent-config
# or
pip install foundry-agent-config

Quickstart​

from pathlib import Path
from pydantic import BaseModel
from foundry_agent_config import load_config

class AppConfig(BaseModel):
    host: str = "localhost"
    port: int = 8000

config = load_config(AppConfig, Path("config.yaml"), env_prefix="MYAPP")
# MYAPP__PORT=9000 overrides config.port to 9000
# MYAPP__MODEL__PROVIDER=ollama overrides config.model.provider

What's in the box​

SurfaceHighlights
load_config(model, yaml_path, env_prefix="")Reads YAML, merges env-var overrides, validates against a Pydantic model
Env-var coercionint, float, bool, list[T] (CSV or JSON), dict, Optional[T]
Nested overridesPREFIX__OUTER__INNER=value traverses nested models
Bounded inputsYAML file size, env var size, and key counts are bounded (DISA STIG V-222612)
ConfigurationErrorRaised on missing file, invalid YAML, non-mapping root, or schema validation failure

Security​

The loader bounds YAML file size, environment-variable size, and key counts to prevent resource-exhaustion attacks (DISA STIG V-222612). Command-execution sinks are prohibited and gated by Ruff S6xx rules plus bandit narrow-set in CI (DISA STIG V-222604). See the STIG checklist.

Reference​