Environment Variables
Environment variables Agno reads: provider API keys, AgentOS security keys, CLI settings, and debug flags.
Agno reads configuration from environment variables. The ones you are most likely to need:
| Variable | Used by | Purpose |
|---|---|---|
OPENAI_API_KEY | SDK | Key for the default model (OpenAIResponses) and the default OpenAIEmbedder |
ANTHROPIC_API_KEY, GOOGLE_API_KEY, GROQ_API_KEY, ... | SDK | Each model provider reads its own key. See the provider's page in Models for the exact name |
OS_SECURITY_KEY | AgentOS | Bearer token for security key authentication |
JWT_VERIFICATION_KEY | AgentOS | Public key or shared secret for JWT verification |
JWT_JWKS_FILE | AgentOS | Path to a JWKS file. Alternative to JWT_VERIFICATION_KEY |
AGENTOS_URL | CLI | AgentOS URL for agno connect, agno status, and agno tokens |
AGNO_ADMIN_TOKEN | CLI | Admin credential for agno connect and agno tokens. Falls back to OS_SECURITY_KEY |
AGNO_DEBUG | SDK | Set to true to enable debug logging |
AGNO_TELEMETRY | Agents, teams, workflows | Set to false to disable telemetry for these components. Configure AgentOS and eval telemetry per instance. |
Setting a Variable
export OPENAI_API_KEY="sk-..."These last for the current shell session. To persist a variable, add the export line to your shell profile (~/.zshrc, ~/.bashrc, or your PowerShell profile), or use setx on Windows.