huggingface/.env.huggingface

# ===========================================================================
# MediGuard AI — HuggingFace Spaces Secrets Reference
# ===========================================================================
# Copy these to your HuggingFace Space Settings → Secrets
# ===========================================================================

# ===========================================================================
# REQUIRED: LLM API Key (choose one)
# ===========================================================================

# Option 1: Groq (RECOMMENDED - fast, free)
# Get key at: https://console.groq.com/keys
GROQ_API_KEY=your_groq_api_key_here

# Option 2: Google Gemini (free tier)
# Get key at: https://aistudio.google.com/app/apikey
# GOOGLE_API_KEY=your_google_api_key_here

# ===========================================================================
# OPTIONAL: LLM Model Configuration
# ===========================================================================

# Groq model (default: llama-3.3-70b-versatile)
# Options: llama-3.3-70b-versatile, llama-3.1-8b-instant, mixtral-8x7b-32768
# GROQ_MODEL=llama-3.3-70b-versatile

# Gemini model (default: gemini-2.0-flash)
# Options: gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash
# GEMINI_MODEL=gemini-2.0-flash

# Force specific provider (auto-detected from keys if not set)
# LLM_PROVIDER=groq

# ===========================================================================
# OPTIONAL: Embeddings Configuration
# ===========================================================================

# Embedding provider (default: huggingface - local, no API needed)
# Options: jina (high-quality 1024d), google, huggingface
# EMBEDDING_PROVIDER=huggingface

# Jina AI API key for high-quality embeddings
# Get key at: https://jina.ai/ (free tier available)
# JINA_API_KEY=your_jina_api_key_here

# ===========================================================================
# OPTIONAL: Observability (Langfuse)
# ===========================================================================

# Enable Langfuse tracing (default: false)
# LANGFUSE_ENABLED=true

# Langfuse credentials (required if LANGFUSE_ENABLED=true)
# Get at: https://cloud.langfuse.com/
# LANGFUSE_PUBLIC_KEY=pk-lf-xxx
# LANGFUSE_SECRET_KEY=sk-lf-xxx
# LANGFUSE_HOST=https://cloud.langfuse.com

# ===========================================================================
# Notes:
# ===========================================================================
# 
# 1. At minimum, you need either GROQ_API_KEY or GOOGLE_API_KEY
# 2. Groq is recommended for best speed/quality balance (free tier)
# 3. HuggingFace embeddings run locally - no API key needed (default)
# 4. Jina embeddings are higher quality but require API key
# 5. Langfuse provides observability for debugging and monitoring
#
# ===========================================================================