Skip to main content

Required variables

OPENAI_API_KEY=...
DZAP_STARTUP_PASSWORD=alohomora

Common runtime variables

VariableDefaultPurpose
PORT3001HTTP server port
DZAP_OPENAI_MODELgpt-4o-miniModel override
DZAP_MODEL_MAX_RETRIES2Model retry count
DZAP_MODEL_TIMEOUT_MS4500000Model timeout
LOG_LEVELinfoRuntime logging level
DB_PATHschedules.dbScheduler SQLite path

CLI-specific variables

VariablePurpose
DZAP_CLI_DEBUGToggle debug output defaults
DZAP_CONFIRM_TRANSACTIONSDefault transaction confirmation behavior

RPC override variables

Resolution order for transaction execution:
  1. DZAP_RPC_URL_<chainId>
  2. RPC_URL_<chainId>
  3. DZAP_RPC_URL
  4. built-in public RPC fallback list

Optional provider keys

VariableUsed by
CRYPTOPANIC_API_KEYTrendingNewsTool
TAVILY_API_KEYWebSearchTool
COINSTATS_API_KEYCoinStats wrapper tools
MORALIS_API_KEYMoralis wrapper tools

Profile file

  • macOS/Linux: ~/.dzapai/config.json
  • Windows: %USERPROFILE%\.dzapai\config.json
Example:
{
  "wallet": "0xYourAddress",
  "chain": "42161",
  "blockchain": "evm",
  "privateKey": "0x..."
}

Scheduler storage

By default, schedules are persisted to schedules.db in the runtime working directory.
Last modified on May 26, 2026