.env.example

# Soulfield OS Environment Configuration
# Copy this file to `.env` and fill in your values

# ---- Core API & Models ----
ANTHROPIC_API_KEY=your-anthropic-key-here
CLAUDE_API_KEY=your-claude-key-here
AIDEN_MODEL=claude-sonnet-4-5-20250929
OPENAI_API_KEY=your-openai-key-here
PERPLEXITY_API_KEY=your-perplexity-key-here
TAVILY_API_KEY=your-tavily-key-here

# Z.ai (Cost-Optimized Execution Agents)
# GLM-4.6-Plus: $0.42/1M tokens (8x cheaper than Claude) or $0 with subscription
# Used for @builder, @distributor, @metrics (high-volume generation tasks)
ZAI_API_KEY=your-zai-api-key-here
ZAI_MODEL=glm-4-plus

# ---- RAG Escalation (InfraNodus-Enhanced) ----
# Enable intelligent RAG escalation based on graph analysis
ENABLE_RAG_ESCALATION=0
RAG_DEFAULT_PROVIDER=perplexity
RAG_ENABLE_FALLBACK=1
RAG_MIN_QUALITY_SCORE=60
RAG_MAX_GAPS=1
RAG_MIN_MODULARITY=0.25
RAG_MAX_ESCALATIONS=1
RAG_MAX_QUERIES=3

# ---- Dynamic Pipeline Selection (InfraNodus-Guided) ----
# Enable intelligent lens selection based on content analysis
# Reduces lens execution time by 68% while maintaining quality
USE_DYNAMIC_PIPELINE=0
ENABLE_GRAPH_ANALYSIS=1
GRAPH_ANALYSIS_THRESHOLD=200
STRUCTURE_QUALITY_THRESHOLD=60

# ---- Server Configuration ----
PORT=8790
DEV_NO_API=0
ALLOW_AUTO_COMMANDS=0
CHAT_API_TOKEN=

# ---- Memory & Embeddings ----
# Supabase (pgvector) - Primary vector memory system
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-supabase-anon-key
SUPABASE_SERVICE_KEY=your-supabase-service-key

# Embeddings provider (used by Supabase vector search)
EMBED_PROVIDER=local
MEMORY_UPSERT_BATCH=64

# ---- Agent Tools & APIs ----
# Jina AI (embeddings/rerank)
JINA_API_KEY=your-jina-key-here
JINA_EMBEDDING_MODEL=jina-embeddings-v2-base-en
JINA_RERANK_MODEL=jina-reranker-v1-base-en

# InfraNodus (text analysis and knowledge graphs)
INFRANODUS_API_KEY=your-infranodus-key-here
INFRANODUS_API_BASE=https://infranodus.com/api/v1
INFRANODUS_DEFAULT_OPTIMIZE=develop
INFRANODUS_DEFAULT_MODEL=gpt-4o-mini

# Bright Data (web scraping)
BRIGHTDATA_TOKEN=your-brightdata-token-here
BD_BASE_URL=https://api.brightdata.com
BD_TIMEOUT_MS=30000

# BrightData multi-query controls
BD_MULTI_QUERY=1
BD_MULTI_QUERY_BASE="AI business automation go-to-market"
BD_MULTI_QUERY_VARIATIONS=5

# BrightData Template Endpoints (zone-based)
BD_TMPL_GOOGLE_SERP=/request
BD_ZONE_SERP=serp_api1
BD_TMPL_GOOGLE_NEWS=/request
BD_ZONE_NEWS=serp_api1
BD_TMPL_EBAY_SEARCH=/request
BD_ZONE_EBAY_SEARCH=serp_api1
BD_TMPL_EBAY_PRODUCT=/request
BD_ZONE_EBAY_PRODUCT=serp_api1
BD_TMPL_AMAZON_SEARCH=/request
BD_ZONE_AMAZON_SEARCH=serp_api1

# BrightData SERP Enhancement Options
BD_SERP_COUNTRY=US
BD_SERP_MAX_RESULTS=30
BD_SERP_PAGE_DEPTH=3
BD_SERP_FORMAT=json
BD_SERP_PARSE_ADS=false
BD_SERP_PARSE_LOCAL=true
BD_SERP_PARSE_SHOPPING=true
BD_SERP_PARSE_KNOWLEDGE=true

# ---- Google Workspace (MCP) ----
# OAuth credentials for Google Workspace MCP (calendar, drive, gmail)
GCAL_CLIENT_ID=your-google-client-id
GCAL_CLIENT_SECRET=your-google-client-secret
GCAL_REDIRECT_URI=http://localhost:3000/oauth2callback
GCAL_REFRESH_TOKEN=your-google-refresh-token
GCAL_WINDOW_HOURS=24
GCAL_CALENDAR_ID=primary

# ---- MCP Servers ----
REF_API_KEY=your-ref-api-key
APIFY_TOKEN=your-apify-token
# INFRANODUS_API_KEY configured above in Agent Tools section

# ---- Development Tools ----
GITHUB_TOKEN=your-github-token

# ---- Obsidian Integration (Optional) ----
OBSIDIAN_DIR=./workspace/docs/Obsidian
NOTES_DIR=./workspace/docs/Obsidian

# ---- Training Data (Docling + Supabase) ----
# Enable agents to recall training materials from processed documents
USE_TRAINING_DATA=1
TRAINING_DATA_LIMIT=2