.env-example

# VeriFact Environment Configuration
# =================================
# Copy this file to .env and customize with your own values
# Required variables are marked with [REQUIRED]

# ===== MODEL ACCESS AND SELECTION (OPENAI) =====

OPENAI_API_KEY=your-openai-api-key-here           # For embeddings and optional model access 

# Default model for general processing and fallback
DEFAULT_MODEL=gpt-4o
# Alternatives:
# DEFAULT_MODEL=qwen/qwen3-8b:free                   # Better for multilingual, Apache-2 license
# DEFAULT_MODEL=microsoft/phi-4-reasoning:free       # Lightweight, MIT licensed

# Claim Detector model - identifies factual claims from text
CLAIM_DETECTOR_MODEL=gpt-4o-mini

# Evidence Hunter model - gathers and evaluates evidence
EVIDENCE_HUNTER_MODEL=gpt-4o-mini

# Verdict Writer model - analyzes evidence and generates verdicts
VERDICT_WRITER_MODEL=o4-mini

# Model Parameters
MODEL_TEMPERATURE=0.1                             # Lower values: more deterministic
MODEL_MAX_TOKENS=1000                             # Maximum response length
MODEL_REQUEST_TIMEOUT=120                         # Timeout in seconds

# Search Configuration 
SERPER_API_KEY=your_serper_api_key_here           # Only needed if USE_SERPER=true

# ===== DATABASE CONFIGURATION =====

# Supabase Configuration
SUPABASE_URL=https://your-project.supabase.co     # [REQUIRED] URL from Supabase dashboard
SUPABASE_KEY=your-supabase-anon-key               # [REQUIRED] Public anon key
SUPABASE_SERVICE_ROLE_KEY=your-supabase-service-role-key  # [REQUIRED] For admin operations
SUPABASE_DB_URL=your_supabase_database_url        # [REQUIRED] Get from Connection Pooling section in Supabase

# ===== APPLICATION CONFIGURATION =====

# Redis Configuration
REDIS_ENABLED=true                                # Enable Redis caching
REDIS_URL=redis://:${REDIS_PASSWORD:-}@localhost:6379/0  # Redis URL for local setup
REDIS_PASSWORD=your-redis-password                # Redis password (leave empty for no password)
REDIS_CACHE_TTL=86400                             # Default cache TTL in seconds (24 hours)
EVIDENCE_CACHE_TTL=86400                          # Evidence cache TTL in seconds (24 hours)

# Database Pool Settings
DB_POOL_MIN_SIZE=2                                # Minimum connections in pool
DB_POOL_MAX_SIZE=10                               # Maximum connections in pool
DB_POOL_MAX_IDLE_TIME=300                         # Max idle time for connections
DB_COMMAND_TIMEOUT=60.0                           # Command timeout in seconds

# Chainlit UI Configuration
CHAINLIT_HOST=0.0.0.0                             # Listen on all interfaces
CHAINLIT_PORT=8501
CHAINLIT_AUTH_SECRET=your_chainlit_auth_secret    # Required if auth is enabled
CHAINLIT_AUTH_ENABLED=false                       # Set to true to enable authentication
CHAINLIT_PERSIST=true                             # Persist chats in the database

# API Configuration
HOST=0.0.0.0                                      # Listen on all interfaces
PORT=8000
API_KEY_ENABLED=true                              # Enable API key authentication
API_KEY_HEADER_NAME=X-API-Key                     # Header name for API keys
DEFAULT_API_KEY=your-default-api-key              # Default API key
RATE_LIMIT_ENABLED=true                           # Enable rate limiting
RATE_LIMIT_REQUESTS=100                           # Number of requests per window
RATE_LIMIT_WINDOW=3600                            # Rate limit window in seconds

# ===== ADVANCED CONFIGURATION =====

# Embedding Configuration
EMBEDDING_MODEL=text-embedding-3-small            # Model for generating embeddings
ENABLE_MODEL_CACHING=true                         # Cache model responses
MODEL_CACHE_SIZE=1000                             # Number of responses to cache

# Logging Configuration
ENVIRONMENT=development
LOG_LEVEL=INFO                                    # DEBUG, INFO, WARNING, ERROR, CRITICAL
LOG_FORMAT=plain
# LOG_FILE=/path/to/log/file.log                  # Uncomment to enable file logging