.env.example

# ── Context Engine — Environment Configuration ──────────────────────────────
# Copy this file to .env and fill in your values.
# cp .env.example .env

# ── Environment ──────────────────────────────────────────────────────────────
# development | production
ENVIRONMENT=development

# ── Database ─────────────────────────────────────────────────────────────────
# SQLite (default — zero setup, stores in ./data/context.db)
DATABASE_URL=sqlite+aiosqlite:///data/context.db

# PostgreSQL (recommended for production)
# DATABASE_URL=postgresql://user:password@localhost:5432/context_engine

# ── Data directory ────────────────────────────────────────────────────────────
# Where uploads and the SQLite file are stored
DATA_DIR=./data

# ── AI / LLM Extraction (optional) ──────────────────────────────────────────
# Without these, the built-in regex extractor is used (no AI key required).
# The app works fully offline without these — AI is additive, not required.

# Your API key for the LLM provider you choose
# Google AI Studio key:  AIza...
# Anthropic key:         sk-ant-...
# OpenAI key:            sk-...
LITELLM_API_KEY=

# Model name in LiteLLM format for entity extraction
# Google:    gemini/gemini-2.5-flash
# Anthropic: claude-3-5-haiku-20241022
# OpenAI:    gpt-4o-mini
EXTRACTION_MODEL=

# Model name for embeddings (optional — enables semantic search)
# OpenAI:  text-embedding-3-small
# Leave empty to use keyword search instead
EMBEDDING_MODEL=

# ── OAuth Connectors (optional) ──────────────────────────────────────────────
# Only needed if you want to connect Google Drive / Gmail / Slack.
# Leave all blank if you only use file uploads and GitHub.

# Google OAuth (for Gmail + Google Drive connectors)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
# Optional: override the redirect URI used for Google OAuth. If unset, the app
# builds it from PUBLIC_BASE_URL + /api/connectors/{gmail|gdrive}/callback.
# Set this explicitly if your app is behind a reverse proxy or if Google
# Console requires an exact URI that differs from the detected request URL.
GOOGLE_REDIRECT_URI=

# Slack OAuth (for Slack connector)
# Create a Slack app at https://api.slack.com/apps
SLACK_CLIENT_ID=
SLACK_CLIENT_SECRET=

# Managed one-click Slack OAuth (optional)
# Set this to the hosted Context Engine Slack app install URL.
# When present, the primary Slack button uses this instead of self-hosted credentials.
SLACK_MANAGED_INSTALL_URL=
ENCRYPTION_KEY=

# Externally reachable app URL used for OAuth callbacks.
# REQUIRED for Google and Slack OAuth to work in production or behind a proxy.
# Must match the origin registered in the Google/Slack app console.
# Example: https://app.example.com
# Local development falls back to the incoming request host (may fail with
# redirect_uri_mismatch if the console registration does not match localhost).
PUBLIC_BASE_URL=

# ── Server ───────────────────────────────────────────────────────────────────
# Port the server listens on (Docker: also update docker-compose.yml PORT)
PORT=8000