backend/.env.example

# MEXAR Core Engine - Backend Environment Variables
# Copy this file to .env and fill in your values

# ===========================================
# REQUIRED: Groq API (LLM, Whisper, Vision)
# ===========================================
# Get your free API key at: https://console.groq.com
GROQ_API_KEY=your_groq_api_key_here

# ===========================================
# REQUIRED: Database
# ===========================================
# PostgreSQL with pgvector extension
# For Supabase: Copy from Settings > Database > Connection string
DATABASE_URL=postgresql://user:password@host:5432/database

# ===========================================
# REQUIRED: Security
# ===========================================
# Generate a secure random key for JWT tokens
# Example: python -c "import secrets; print(secrets.token_urlsafe(32))"
SECRET_KEY=your_secure_secret_key_here

# ===========================================
# REQUIRED: Supabase Storage
# ===========================================
# Get from Supabase Dashboard > Settings > API
SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_KEY=your_supabase_service_role_key

# ===========================================
# OPTIONAL: Text-to-Speech
# ===========================================
# ElevenLabs API (10,000 chars/month free)
# Get at: https://elevenlabs.io
ELEVENLABS_API_KEY=your_elevenlabs_api_key_here

# ===========================================
# OPTIONAL: Local Storage Path
# ===========================================
# For development only, production uses Supabase Storage
STORAGE_PATH=./data/storage

# ===========================================
# PHASE 2: Dataset Collection Scripts
# ===========================================
# Required for backend/scripts/fetch_courtlistener.py
# Free account + token at: https://www.courtlistener.com/sign-in/
COURTLISTENER_TOKEN=token_api

# Required for backend/scripts/fetch_pubmed.py
# NCBI usage policy requires a valid email address on every request.
NCBI_EMAIL=example@example.com

# Optional: NCBI API key raises rate limit from 3 req/sec → 10 req/sec.
# Register at: https://www.ncbi.nlm.nih.gov/account/
NCBI_API_KEY=sample_api_key

# Required for backend/scripts/fetch_secedgar.py
# SEC fair access policy: format must be "FirstName LastName email@example.com"
SEC_USER_AGENT=YourName your@email.com