Environment Variables

AgentZero reads several environment variables for API keys, backend selection, and runtime overrides.

Core Variables

Variable	Description	Default
`OPENAI_API_KEY`	API key for OpenAI-compatible providers	—
`AGENTZERO_DATA_DIR`	Override data/config directory	`~/.agentzero`
`AGENTZERO_CONFIG`	Override config file path	`$DATA_DIR/agentzero.toml`
`AGENTZERO_MEMORY_BACKEND`	Memory backend (`sqlite` or `turso`)	`sqlite`
`RUST_LOG`	Logging level (also set via `-v` flags)	—

Provider Keys

Variable	Description
`OPENAI_API_KEY`	OpenAI, OpenRouter, or any OpenAI-compatible provider
`ANTHROPIC_API_KEY`	Anthropic direct API access
`BRAVE_API_KEY`	Brave Search API (for `web_search` tool)
`PERPLEXITY_API_KEY`	Perplexity Search API
`EXA_API_KEY`	Exa Search API
`JINA_API_KEY`	Jina Reader/Search API
`COMPOSIO_API_KEY`	Composio integration API

Memory Backend

Variable	Description
`AGENTZERO_MEMORY_BACKEND`	`sqlite` (default) or `turso`
`TURSO_AUTH_TOKEN`	Auth token for Turso/libsql remote backend
`TURSO_DATABASE_URL`	Turso database URL

Verbosity via CLI

The -v flag maps to RUST_LOG levels:

agentzero -v status        # RUST_LOG=error
agentzero -vv status       # RUST_LOG=info
agentzero -vvv status      # RUST_LOG=debug
agentzero -vvvv status     # RUST_LOG=trace

JSON Output

Any command supports --json for machine-readable output:

agentzero --json status

Output format:

{
  "ok": true,
  "command": "status",
  "result": { ... },
  "error": null
}