.env.example

# ============================================================
# VoiceVault — Environment Variables Template
# Copy this file to .env and fill in your values.
# NEVER commit .env to version control.
# ============================================================

# --- Required: LLM API Keys -------------------------------------------
# Groq API key — free tier: 14,400 req/day, 500 tok/sec
# Get yours at: https://console.groq.com/
GROQ_API_KEY=gsk_your_groq_key_here

# Google Gemini API key — free tier: 1,000,000 tokens/day (fallback)
# Get yours at: https://aistudio.google.com/
GEMINI_API_KEY=AIza_your_gemini_key_here

# --- Optional: Model Overrides ----------------------------------------
# Whisper model (HuggingFace model ID)
# WHISPER_MODEL=openai/whisper-large-v3

# Distil-Whisper CPU fallback model
# DISTIL_WHISPER_MODEL=distil-whisper/distil-large-v3

# Embedding model (sentence-transformers)
# EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2

# Cross-encoder reranking model
# CROSS_ENCODER_MODEL=cross-encoder/ms-marco-MiniLM-L12-v2

# Primary LLM (Groq)
# GROQ_LLM_MODEL=llama-3.1-70b-versatile

# Fallback LLM (Gemini)
# GEMINI_LLM_MODEL=gemini-1.5-flash

# --- Optional: Retrieval Tuning ---------------------------------------
# BM25_TOP_K=20
# VECTOR_TOP_K=20
# RRF_K=60
# RERANK_TOP_K=20
# FINAL_TOP_K=5

# --- Optional: Chunking Tuning ----------------------------------------
# CHUNK_SIZE_MIN=100
# CHUNK_SIZE_MAX=600
# CHUNK_OVERLAP=50
# SEMANTIC_SIMILARITY_THRESHOLD=0.5

# --- Optional: Server -------------------------------------------------
# HOST=0.0.0.0
# PORT=7860
# DEBUG=false