.env.example

# Environment Configuration
# Copy this file to .env and update with your values

# ============================================
# Environment Settings
# ============================================
# Options: development, testing, production
ENVIRONMENT=development

# Enable development mode (optional)
DEV=true

# ============================================
# Database Configuration
# ============================================
# Database connection URL
DB_URL=sqlite:///records.db

# PostgreSQL example (requires postgres extra: uv sync --extra postgres):
# DB_URL=postgresql://user:pass@localhost/dbname

# MySQL example:
# DB_URL=mysql://user:pass@localhost/dbname

# Echo SQL queries (set true for debugging)
DB_ECHO=false

# ============================================
# WhisperX ML Configuration
# ============================================
# Required for model downloads from HuggingFace
HF_TOKEN=<your-huggingface-token>

# Whisper model size
# Options: tiny, tiny.en, base, base.en, small, small.en, medium, medium.en,
#          large, large-v1, large-v2, large-v3, large-v3-turbo,
#          distil-large-v2, distil-large-v3, distil-medium.en, distil-small.en
WHISPER_MODEL=tiny

# Default transcription language code (ISO 639-1)
DEFAULT_LANG=en

# Device to use for computation
# Options: cuda, cpu (auto-detected if not set)
DEVICE=cuda

# Compute type for model inference
# Options: float16, float32, int8
# CRITICAL: MUST be int8 when DEVICE=cpu
COMPUTE_TYPE=float16

# ============================================
# Logging Configuration
# ============================================
# Logging level
# Options: DEBUG, INFO, WARNING, ERROR, CRITICAL
LOG_LEVEL=INFO

# Log format
# Options: text, json
LOG_FORMAT=text

# Filter specific warnings
FILTER_WARNING=true

# ============================================
# Notes
# ============================================
# - Required fields: HF_TOKEN (for model downloads)
# - When using CPU (DEVICE=cpu), you MUST set COMPUTE_TYPE=int8
# - Environment variables can use nested format with __ separator:
#   - database__DB_URL=sqlite:///records.db
#   - whisper__WHISPER_MODEL=tiny
#   - logging__LOG_LEVEL=DEBUG