.env.example

# Copy to `.env` and fill in real values. `.env` is gitignored.
# The app refuses to start when GEMINI_API_KEY is missing or empty.

# --- Gemini ---------------------------------------------------------------
# Required. Get a key at https://aistudio.google.com/app/apikey.
# Boilerplate stage only checks presence; the first ingest/query feature
# validates the key against Gemini for real.
GEMINI_API_KEY=your-gemini-key-here

# Model identifiers. Constitution v1.0.3 pins `gemini-embedding-001` and
# `gemini-2.5-flash` — both bumped on 2026-05-12 after Google retired the
# previously-pinned `text-embedding-004` and `gemini-2.0-flash` IDs for
# new keys (v1beta returns 404 on the old names).
EMBEDDING_MODEL=gemini-embedding-2
GENERATION_MODEL=gemini-2.5-flash
GROUNDING_JUDGE_MODEL=gemini-2.5-flash-lite

# --- Database -------------------------------------------------------------
# Required. Default points at the `db` service inside docker compose.
DATABASE_URL=postgresql://rag:rag@db:5432/rag

# Used by the `db` service to initialize the database on first up.
POSTGRES_USER=rag
POSTGRES_PASSWORD=rag
POSTGRES_DB=rag

# --- Embedding ------------------------------------------------------------
# Must match the vector(N) column type in migration 0001. Constitution
# pins 768 (passed to `gemini-embedding-001` as `output_dimensionality`,
# which natively defaults to 3072). Changing this without re-migrating
# the schema fails fast at startup with a dimension-mismatch error.
EMBEDDING_DIM=768


# --- Upload (feature 003) -------------------------------------------------
# Max upload size in bytes for `POST /ui/upload`. Default 100 MiB
# (104,857,600 bytes). Spec FR-015. Files exceeding the cap are rejected
# with HTTP 413 before any extraction or embedding work happens.
RAG_MAX_UPLOAD_BYTES=104857600

# --- Logging --------------------------------------------------------------
# One of DEBUG, INFO, WARNING, ERROR.
LOG_LEVEL=INFO