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	SDK	Set to false to disable telemetry

Setting a Variable

macOS / Linux

export OPENAI_API_KEY="sk-..."

$env:OPENAI_API_KEY = "sk-..."

set 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.

Next Steps

• Models overview
• AgentOS security
• Agno CLI