.env.example

# Copy to .env and fill in. .env is gitignored.
# See docs/CONFIGURATION.md and docs/AZURE_SETUP.md for details.

# Config (optional; default is docproc.yaml in project root)
# DOCPROC_CONFIG=docproc.yaml

# Frontend: API base URL (for Streamlit; default http://localhost:8000)
# DOCPROC_API_URL=http://localhost:8000

# ---------------------------------------------------------------------------
# Azure OpenAI (chat, embeddings)
# ---------------------------------------------------------------------------
# When using Azure, set DOCPROC_PRIMARY_AI=azure so the app uses Azure instead of OpenAI.
DOCPROC_PRIMARY_AI=azure
AZURE_OPENAI_API_KEY=your-azure-openai-key
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
# Chat model: deployment name in Azure (must match name in Azure Portal)
AZURE_OPENAI_DEPLOYMENT=gpt-4o
# Embedding model: deployment name in Azure (create an "Embeddings" deployment in the same resource; name must match exactly)
AZURE_OPENAI_EMBEDDING_DEPLOYMENT=text-embedding-ada-002

# Azure AI Vision (optional) — image extraction (Describe + Read OCR)
# Endpoint: https://<resource>.cognitiveservices.azure.com/
AZURE_VISION_ENDPOINT=

# ---------------------------------------------------------------------------
# Database (override docproc.yaml database.connection_string)
# ---------------------------------------------------------------------------
# Postgres: for Docker use postgres:5432; for local use localhost:5432
DATABASE_URL=postgresql://postgres:postgres@postgres:5432/docproc

# ---------------------------------------------------------------------------
# Alternative: OpenAI (if primary_ai: openai in docproc.yaml)
# ---------------------------------------------------------------------------
# OPENAI_API_KEY=sk-...
# OPENAI_BASE_URL=  # optional
# Chat model (e.g. gpt-4o, gpt-5.2)
# OPENAI_DEFAULT_MODEL=gpt-5.2

# ---------------------------------------------------------------------------
# AI assessment (question generation + long-answer evaluation)
# ---------------------------------------------------------------------------
# AI_PROVIDER=          # optional; defaults to DOCPROC_PRIMARY_AI
# AI_MODEL_PRIMARY=     # model for generation and primary grader
# AI_MODEL_SECONDARY=   # model for secondary grader (arbitration)
# AI_TEMPERATURE=0.2
# AI_TIMEOUT=60
# AI_MAX_RETRIES=3
# AI_DISABLED=false     # set true to disable AI generation and evaluation
# AI_EVAL_DISCREPANCY_THRESHOLD=10
# AI_MAX_ANSWER_TOKENS=2000