env.example

# MAESTRO Environment Configuration
# Copy this file to .env and modify the values as needed

# =============================================================================
# NETWORK CONFIGURATION
# =============================================================================

# Backend Configuration
BACKEND_HOST=127.0.0.1
BACKEND_PORT=8000
BACKEND_INTERNAL_PORT=8000

# Frontend Configuration
FRONTEND_HOST=127.0.0.1
FRONTEND_PORT=3000
FRONTEND_INTERNAL_PORT=3000

# API Protocol Configuration
API_PROTOCOL=http
WS_PROTOCOL=ws

# =============================================================================
# TIMEZONE AND LOCALIZATION
# =============================================================================

# System timezone (used by all services)
TZ=America/Chicago

# Frontend timezone display
VITE_SERVER_TIMEZONE=America/Chicago

# =============================================================================
# LOGGING AND DEBUGGING
# =============================================================================

# Log level for all services (debug, info, warning, error)
LOG_LEVEL=info

# Python-specific logging
TRANSFORMERS_VERBOSITY=error
TOKENIZERS_PARALLELISM=false
TF_CPP_MIN_LOG_LEVEL=2
PYTHONWARNINGS=ignore

# =============================================================================
# PERFORMANCE AND RESOURCE CONFIGURATION
# =============================================================================

# Maximum worker threads for backend processing
# Increased to 20 to handle concurrent web fetches without blocking
MAX_WORKER_THREADS=20

# =============================================================================
# GPU CONFIGURATION (Optional - for NVIDIA GPUs)
# =============================================================================

# GPU device IDs for different services
# Set to 'all' to use all available GPUs, or specific device IDs like '0', '1', etc.
# Leave empty or set to '' to disable GPU support for that service

# Backend service GPU device
BACKEND_GPU_DEVICE=

# Document processor service GPU device
DOC_PROCESSOR_GPU_DEVICE=

# CLI service GPU device
CLI_GPU_DEVICE=

# =============================================================================
# LOCAL LLM CONFIGURATION (Optional)
# =============================================================================

# Uncomment and configure if using local LLM (e.g., Ollama)
# LOCAL_LLM_HOST=127.0.0.1
# LOCAL_LLM_PORT=11434
# LOCAL_LLM_INTERNAL_PORT=11434

# =============================================================================
# DEVELOPMENT AND TESTING
# =============================================================================

# Enable development mode features
# Set to 'true' for development, 'false' for production
DEV_MODE=true

# =============================================================================
# SECURITY AND AUTHENTICATION
# =============================================================================

# JWT Secret (generate a secure random string for production)
# You can generate one with: openssl rand -hex 32
JWT_SECRET=your-secret-key-here-change-in-production

# Session timeout in seconds (default: 24 hours)
SESSION_TIMEOUT=86400

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

# Database URL (SQLite is used by default)
DATABASE_URL=sqlite:///./maestro.db

# =============================================================================
# EXTERNAL API KEYS (Optional)
# =============================================================================

# OpenAI API Key (if using OpenAI models)
# OPENAI_API_KEY=your-openai-api-key-here

# Anthropic API Key (if using Claude models)
# ANTHROPIC_API_KEY=your-anthropic-api-key-here

# Google API Key (if using Google services)
# GOOGLE_API_KEY=your-google-api-key-here

# =============================================================================
# FILE STORAGE AND CACHING
# =============================================================================

# Model cache directory (relative to project root)
MODEL_CACHE_DIR=./maestro_model_cache

# Data cache directory (relative to project root)
DATA_CACHE_DIR=./maestro_datalab_cache

# Reports directory (relative to project root)
REPORTS_DIR=./reports

# PDF upload directory (relative to project root)
PDF_DIR=./pdfs

# =============================================================================
# WEBHOOKS AND INTEGRATIONS (Optional)
# =============================================================================

# Webhook URL for notifications (optional)
# WEBHOOK_URL=https://your-webhook-url.com/notifications

# Slack webhook URL (optional)
# SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK

# =============================================================================
# MONITORING AND ANALYTICS (Optional)
# =============================================================================

# Enable usage analytics (true/false)
ENABLE_ANALYTICS=false

# Analytics endpoint (if using external analytics service)
# ANALYTICS_ENDPOINT=https://your-analytics-service.com/collect

# =============================================================================
# BACKUP AND RECOVERY
# =============================================================================

# Auto-backup enabled (true/false)
AUTO_BACKUP=false

# Backup schedule (cron format, e.g., "0 2 * * *" for daily at 2 AM)
BACKUP_SCHEDULE="0 2 * * *"

# Backup retention days
BACKUP_RETENTION_DAYS=30

# =============================================================================
# NOTES AND COMMENTS
# =============================================================================

# This file contains all configurable environment variables for MAESTRO
# 
# To use this file:
# 1. Copy this file to .env: cp env.example .env
# 2. Edit the .env file with your specific values
# 3. Run the setup script: ./setup-env.sh (Linux/Mac) or setup-env.bat (Windows)
#
# For Windows users:
# - Use setup-env.bat for batch file compatibility
# - Use setup-env.ps1 for PowerShell compatibility
# - Use maestro-cli.bat for CLI operations with batch files
# - Use maestro-cli.ps1 for CLI operations with PowerShell
#
# GPU Configuration Notes:
# - Set GPU device IDs to enable GPU acceleration
# - Use 'all' to use all available GPUs
# - Use specific device IDs like '0', '1' for specific GPUs
# - Leave empty to disable GPU support
# - Requires NVIDIA Container Toolkit for Docker GPU support
#
# Security Notes:
# - Change JWT_SECRET in production
# - Use HTTPS/WSS in production environments
# - Keep API keys secure and never commit them to version control