.env.example

# ──────────────────────────────────────────────────────────────────
# MyBookshelfAI — environment variable overrides
#
# The PREFERRED way to configure API keys and models is through
# the Settings page in the web UI (http://localhost:5173 → Settings).
# Settings saved there are persisted in the local database.
#
# Environment variables below serve as FALLBACKS for Docker or
# headless (no-UI) deployments. If a value is set both here and
# in the Settings UI, the UI value takes priority.
# ──────────────────────────────────────────────────────────────────

# LLM provider credentials (optional overrides)
# LLM_API_KEY=sk-your-key-here
# LLM_BASE_URL=https://api.openai.com/v1

# Model overrides — any OpenAI-compatible model name
# LLM_MODEL_RECOMMEND — online: enrichment, recommendations, tag localization
# LLM_MODEL_ENRICH — legacy fallback if LLM_MODEL_RECOMMEND is unset
# LLM_MODEL_PROFILE — offline: reader profile summary
# LLM_MODEL_PROFILE=gpt-4o-mini
# LLM_MODEL_RECOMMEND=gpt-4o-mini-search-preview
# LLM_MODEL_ENRICH=gpt-4o-mini-search-preview

# Debug mode (verbose logging)
DEBUG=false

# Optional override for persistent app data directory (SQLite cache.db lives here)
# MYBOOKSHELFAI_DATA_DIR=/absolute/path/to/mybookshelfai-data