# Graphiti MCP Server Environment Configuration
# =============================================
#
# For LOCAL development: Copy this file to .env and fill in your values
# For FASTMCP CLOUD: Set these in the FastMCP Cloud UI (NOT in .env files)
#
# FastMCP Cloud ignores .env files - you MUST set secrets in the Cloud UI

# =============================================================================
# DATABASE CONFIGURATION (Choose ONE provider)
# =============================================================================

# Database Provider Selection
# Options: neo4j, falkordb
DATABASE_PROVIDER=neo4j

# --- Neo4j Configuration ---
# For local development: bolt://localhost:7687
# For Neo4j Aura (cloud): neo4j+s://xxxxx.databases.neo4j.io
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=your_neo4j_password_here
NEO4J_DATABASE=neo4j

# --- FalkorDB Configuration ---
# For local development: redis://localhost:6379
# For FalkorDB Cloud: redis://username:password@host:port
# FALKORDB_URI=redis://localhost:6379
# FALKORDB_PASSWORD=
# FALKORDB_DATABASE=default_db
# FALKORDB_USER=

# =============================================================================
# LLM PROVIDER CONFIGURATION (Required)
# =============================================================================

# OpenAI (Default)
OPENAI_API_KEY=your_openai_api_key_here

# Optional: Override default model
# LLM_MODEL=gpt-4.1-mini

# --- Alternative LLM Providers ---

# Anthropic
# ANTHROPIC_API_KEY=sk-ant-...

# Google Gemini
# GOOGLE_API_KEY=...
# GOOGLE_PROJECT_ID=
# GOOGLE_LOCATION=us-central1

# Groq
# GROQ_API_KEY=...

# Azure OpenAI
# AZURE_OPENAI_API_KEY=...
# AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
# AZURE_OPENAI_DEPLOYMENT=your-deployment-name
# AZURE_OPENAI_API_VERSION=2024-10-21
# USE_AZURE_AD=false

# =============================================================================
# EMBEDDER CONFIGURATION (Optional - defaults to OpenAI)
# =============================================================================

# Voyage AI (recommended by Anthropic for Claude integrations)
# VOYAGE_API_KEY=...
# Note: Voyage AI uses 1024 dimensions by default

# Embedding dimensions (must match your embedding model)
# OpenAI text-embedding-3-small: 1536
# Voyage AI voyage-3: 1024
# EMBEDDING_DIM=1536

# =============================================================================
# GRAPHITI CONFIGURATION
# =============================================================================

# Group ID for namespacing graph data
GRAPHITI_GROUP_ID=main

# User ID for tracking operations
USER_ID=mcp_user

# Episode ID prefix (optional)
# EPISODE_ID_PREFIX=

# =============================================================================
# PERFORMANCE TUNING
# =============================================================================

# Concurrency Control
# Controls how many episodes can be processed simultaneously
# Default: 10 (suitable for OpenAI Tier 3, mid-tier Anthropic)
#
# Adjust based on your LLM provider's rate limits:
#   - OpenAI Tier 1 (free): 1-2
#   - OpenAI Tier 2: 5-8
#   - OpenAI Tier 3: 10-15
#   - OpenAI Tier 4: 20-50
#   - Anthropic default: 5-8
#   - Anthropic high tier: 15-30
#
# See README.md "Concurrency and LLM Provider 429 Rate Limit Errors" for details
SEMAPHORE_LIMIT=10

# =============================================================================
# FASTMCP CLOUD DEPLOYMENT CHECKLIST
# =============================================================================
# When deploying to FastMCP Cloud, set these in the Cloud UI:
#
# REQUIRED:
# - OPENAI_API_KEY (or your chosen LLM provider key)
# - Database credentials (Neo4j or FalkorDB)
#   - For Neo4j Aura: NEO4J_URI, NEO4J_USER, NEO4J_PASSWORD
#   - For FalkorDB Cloud: FALKORDB_URI, FALKORDB_USER, FALKORDB_PASSWORD
#
# OPTIONAL:
# - DATABASE_PROVIDER (defaults to falkordb)
# - SEMAPHORE_LIMIT (defaults to 10)
# - GRAPHITI_GROUP_ID (defaults to main)
#
# IMPORTANT: FastMCP Cloud IGNORES:
# - .env files
# - config.yaml files
# - if __name__ == "__main__" blocks
# =============================================================================