Configuration
provider.json
The primary model configuration file. Defines available providers and models:Structure
- Top level = provider ID → array of model configs
- Lookup =
providers[provider_id][model_name] - Multiple keys = load-balanced across keys in
api_keys
Fields
Loading
Best Practices
- Keep one
provider.jsonper project (version control it minus the keys) - Put multiple keys in
api_keysfor hot models (automatic rotation) - Use
api_paramsfor stable per-model defaults such asreasoning_effort; pass call-time kwargs when you need a one-off override - Tune
rate_limit_capacityandrate_limit_refill_rateper model based on your tier - Use
max_retries=2for local models (fast failure),max_retries=5for cloud (transient errors)
Environment Variables (.env)
The framework reads.env for logging and observability:
Precedence
Runtime environment →.env file → framework defaults
Recommended Defaults
LOG_LEVEL=WARNING— reduces framework noise during normal useLOG_DIR=logs— keeps logs out of your project root- Langfuse disabled by default — enable only when you need trace collection