Skip to main content

Configuration Reference

Complete environment variable reference for Seer configuration.

Quick Start Configuration​

For basic usage, you only need:

# Required
OPENAI_API_KEY=sk-...

# Optional (for persistence)
DATABASE_URL=postgresql://user:password@host:port/database
REDIS_URL=redis://localhost:6379/0

Docker development automatically configures DATABASE_URL and REDIS_URL.

Required Configuration​

LLM Services​

VariableDescriptionHow to Get
OPENAI_API_KEYOpenAI API key for workflow execution and AI assistanceOpenAI Platform
ANTHROPIC_API_KEYAlternative to OpenAI for Claude modelsAnthropic Console

At least one LLM API key is required.

Core Services (Docker Auto-Configured)​

Database​

VariableDescriptionDefault
DATABASE_URLPostgreSQL connection stringAuto-configured in Docker

Format: postgresql://user:password@host:port/database

Docker: Automatically set to postgresql://postgres:postgres@postgres:5432/seer

Railway: Use the DATABASE_URL provided by Railway Postgres service

Redis​

VariableDescriptionDefault
REDIS_URLRedis connection string for task queueAuto-configured in Docker

Format: redis://host:port/db

Docker: Automatically set to redis://redis:6379/0

Railway: Use the REDIS_URL provided by Railway Redis service

OAuth Integrations​

Google Workspace​

VariableDescriptionHow to Get
GOOGLE_CLIENT_IDOAuth client ID for Google integrationsGoogle Cloud Console
GOOGLE_CLIENT_SECRETOAuth client secretSame as above

Enables: Gmail, Google Drive, Google Sheets tools

GitHub​

VariableDescriptionHow to Get
GITHUB_CLIENT_IDOAuth client ID for GitHub integrationGitHub Developer Settings
GITHUB_CLIENT_SECRETOAuth client secretSame as above
GITHUB_TOKENPersonal access token for repo accessGitHub Tokens

Enables: Repository management, issues, pull requests

Supabase​

VariableDescriptionHow to Get
SUPABASE_CLIENT_IDOAuth client ID for Supabase managementSupabase Dashboard
SUPABASE_CLIENT_SECRETOAuth client secretSame as above
SUPABASE_MANAGEMENT_API_BASEManagement API base URLDefault: https://api.supabase.com

Enables: Supabase project management, REST API tools

Web Services & APIs​

VariableDescriptionHow to Get
TAVILY_API_KEYAPI key for web search capabilitiesTavily

Tool Search (Optional)​

VariableDescriptionHow to Get
PINECONE_API_KEYPinecone API key for semantic tool searchPinecone
PINECONE_INDEX_NAMEPinecone index nameCreate in Pinecone console
CONTEXT7_API_KEYContext7 API key for MCP toolsContext7

Analytics & Monitoring​

PostHog​

VariableDescriptionDefault
POSTHOG_API_KEYPostHog project API key-
POSTHOG_HOSTPostHog instance URL-
POSTHOG_ENABLEDEnable analytics trackingfalse

PostHog URLs:

  • Cloud US: https://app.posthog.com
  • Cloud EU: https://eu.posthog.com
  • Self-hosted: Your Railway/custom URL

Authentication​

Clerk (Cloud Deployments)​

VariableDescription
CLERK_JWKS_URLClerk JWKS endpoint for token verification
CLERK_ISSUERClerk issuer URL

Required for: Cloud deployments with user authentication

Advanced Configuration​

Database Management​

VariableDescriptionDefault
AUTO_APPLY_DATABASE_MIGRATIONSRun Aerich migrations on startuptrue in Railway

Worker Configuration​

See Triggers Documentation for worker-specific configuration.

Tool Indexing​

VariableDescriptionDefault
TOOL_INDEX_AUTO_GENERATEAuto-generate tool search indexEnabled

Trigger Poller​

VariableDescriptionDefault
TRIGGER_POLLER_ENABLEDEnable automatic trigger pollingEnabled

Legacy & Evaluation Configuration​

The following variables are for evaluation and testing workflows. Most users won't need these.

Evaluation Agent​

VariableDescriptionDefault
EVAL_N_ROUNDSNumber of eval rounds per version2
EVAL_N_TEST_CASESTest cases to generate per round1
EVAL_N_VERSIONSTotal versions to evaluate2
EVAL_PASS_THRESHOLDMinimum score to pass (0.0-1.0)0.8
EVAL_AGENT_ARCHITECTUREArchitecture: react or reflexionreflexion
EVAL_REASONING_EFFORTReasoning effort: minimal, medium, highmedium

Target Agent​

VariableDescriptionDefault
TARGET_AGENT_PORTPort for target agent2024
TARGET_AGENT_SETUP_SCRIPTSetup script for target agentpip install -e .
TARGET_AGENT_COMMANDCommand to run target agentlanggraph dev --host 0.0.0.0
TARGET_AGENT_CONTEXT_LEVELContext level (0-3)0

Feature Flags​

VariableDescriptionDefault
EVAL_AGENT_LOAD_DEFAULT_MCPSLoad default MCP servicestrue
EVAL_PLAN_ONLY_MODESkip execution, return after planfalse
EVAL_AGENT_HANDOFF_ENABLEDEnable handoff to eval agentfalse

Other Services​

VariableDescription
NEO4J_URINeo4j graph database URI
NEO4J_USERNAMENeo4j username
NEO4J_PASSWORDNeo4j password
ASANA_WORKSPACE_IDAsana workspace ID
ASANA_TEAM_GIDAsana team GID
ASANA_PROJECT_IDAsana project ID

Configuration Priority​

Environment variables are loaded in this order (highest to lowest priority):

  1. System environment variables
  2. .env file in project root
  3. Defaults in shared/config.py

Viewing Current Configuration​

Configuration is loaded from environment variables and .env file in this priority order:

  1. System environment variables
  2. .env file in project root
  3. Defaults in shared/config.py

You can view your active configuration by checking:

  • Your .env file for local overrides
  • shared/config.py for default values and structure
  • Docker container environment via docker compose exec langgraph-server env | grep -E "OPENAI|ANTHROPIC|GOOGLE|GITHUB|TAVILY"