Skip to content

Environment Variables

This document outlines the environment variables used to configure the application. These variables are typically defined in a .env file, such as variables/local.env. An example file is provided at variables/local.env.example.

General Configuration

Variable Description Default Value
NODE_ENV The runtime environment. development
LOG_LEVEL The logging level. debug
LOG_PRETTY If true, logs will be formatted for human readability. false
PORT The port on which the server will run. 3000
DATABASE_TYPE The type of database to use (firestore, postgres, or memory). memory
DATABASE_NAME The name of the database. typedai
AUTH The authentication mode (single_user or google_iap) single_user
SINGLE_USER_EMAIL The email for the user in single_user mode.
API_BASE_URL The base URL for the API. http://localhost:3000/api/
UI_URL The URL for the user interface. http://localhost:4200/
DEPLOYMENT The deployment mode (e.g., server or local). When not in server mode the human-in-the-loop check will wait for user console input. local

Google Cloud

Variable Description Default Value
GCLOUD_PROJECT The Google Cloud project ID.
GCLOUD_REGION The default Google Cloud region. us-central1
GCLOUD_CLAUDE_REGION The region for Anthropic's Claude model on Vertex AI. us-east5

OpenTelemetry Tracing

Variable Description Default Value
TRACE_AGENT_ENABLED If true, OpenTelemetry tracing is enabled. true
TRACE_SERVICE_NAME The name of the service for tracing. typedai
TRACE_AUTO_INSTRUMENT If true, auto-instrumentation is enabled. false
TRACE_SAMPLE_RATE The trace sample rate. 1

Human-in-the-Loop (HITL)

Variable Description Default Value
HIL_BUDGET The budget in USD for autonomous agents before HITL is triggered. 1
HIL_COUNT The number of agent iterations before HITL is triggered. 5

LLM Provider API Keys

Variable Description
ANTHROPIC_API_KEY API key for Anthropic.
CEREBRAS_API_KEY API key for Cerebras.
DEEPSEEK_API_KEY API key for DeepSeek.
DEEPINFRA_API_KEY API key for DeepInfra.
FIREWORKS_API_KEY API key for Fireworks.
GEMINI_API_KEY API key for Gemini.
GROQ_API_KEY API key for Groq.
MISTRAL_API_KEY API key for Mistral.
NEBIUS_API_KEY API key for Nebius.
OLLAMA_API_URL URL for a local Ollama instance.
OPENAI_API_KEY API key for OpenAI.
OPENROUTER_API_KEY API key for OpenRouter.
PERPLEXITY_API_KEY API key for Perplexity.
SAMBANOVA_API_KEY API key for SambaNova.
TOGETHERAI_API_KEY API key for TogetherAI.
XAI_API_KEY API key for xAI.

GitLab

Variable Description
GITLAB_TOKEN GitLab personal access token.
GITLAB_HOST GitLab host (e.g., www.gitlab.com).
GITLAB_GROUPS Comma-separated list of GitLab groups.

GitHub

Variable Description
GITHUB_TOKEN GitHub personal access token.
GITHUB_ORG GitHub organization.
GITHUB_USER GitHub username.
GITHUB_WEBHOOK_SECRET Secret for GitHub webhooks.

Jira

Variable Description
JIRA_BASE_URL Your Atlassian instance URL.
JIRA_EMAIL Your Jira email address.
JIRA_API_TOKEN Your Jira API token.
Variable Description
GOOGLE_CUSTOM_SEARCH_ENGINE_ID Google Custom Search Engine ID.
GOOGLE_CUSTOM_SEARCH_KEY Google Custom Search API key.
SERP_API_KEY SerpApi API key.

Slack

Variable Description
SLACK_BOT_TOKEN Slack bot token.
SLACK_SIGNING_SECRET Slack signing secret.
SLACK_CHANNELS Comma-separated list of channels for the bot to listen to.
SLACK_APP_TOKEN Slack app-level token.