# Hindsight Environment Variables # Copy this file to .env and fill in your values # LLM Configuration (Required) # Supported providers: openai, groq, ollama, gemini, anthropic, lmstudio, vertexai, minimax HINDSIGHT_API_LLM_PROVIDER=openai HINDSIGHT_API_LLM_API_KEY=your-api-key-here HINDSIGHT_API_LLM_MODEL=gpt-4o-mini HINDSIGHT_API_LLM_BASE_URL=https://api.openai.com/v1 # Example: Anthropic Claude configuration # HINDSIGHT_API_LLM_PROVIDER=anthropic # HINDSIGHT_API_LLM_API_KEY=your-anthropic-api-key # HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-20250514 # Example: Google Vertex AI configuration # HINDSIGHT_API_LLM_PROVIDER=vertexai # HINDSIGHT_API_LLM_MODEL=google/gemini-2.0-flash-001 # HINDSIGHT_API_LLM_VERTEXAI_PROJECT_ID=your-gcp-project-id # HINDSIGHT_API_LLM_VERTEXAI_REGION=us-central1 # HINDSIGHT_API_LLM_VERTEXAI_SERVICE_ACCOUNT_KEY=/path/to/service-account-key.json # Optional, uses ADC if not set # Example: MiniMax configuration (204K context window) # HINDSIGHT_API_LLM_PROVIDER=minimax # HINDSIGHT_API_LLM_API_KEY=your-minimax-api-key # HINDSIGHT_API_LLM_MODEL=MiniMax-M2.5 # Example: LM Studio local configuration (Qwen 2.5 32B recommended) # HINDSIGHT_API_LLM_PROVIDER=lmstudio # HINDSIGHT_API_LLM_API_KEY=lmstudio # HINDSIGHT_API_LLM_BASE_URL=http://localhost:1234/v1 # HINDSIGHT_API_LLM_MODEL=qwen2.5-32b-instruct # API Configuration (Optional) HINDSIGHT_API_HOST=0.0.0.0 HINDSIGHT_API_PORT=8888 HINDSIGHT_API_LOG_LEVEL=info # Base Path / Reverse Proxy Support (Optional) # Set these when deploying behind a reverse proxy with path-based routing # Example: To deploy at example.com/hindsight/, set both to "/hindsight" # HINDSIGHT_API_BASE_PATH=/hindsight # NEXT_PUBLIC_BASE_PATH=/hindsight # Database (Optional - uses embedded pg0 by default) # HINDSIGHT_API_DATABASE_URL=postgresql://user:pass@host:5432/db # HINDSIGHT_API_DATABASE_SCHEMA=public # PostgreSQL schema name (default: public) # Vector Extension (Optional - uses pgvector by default) # Options: "pgvector" (default), "vchord", "pgvectorscale" (DiskANN) # HINDSIGHT_API_VECTOR_EXTENSION=pgvector # For Azure PostgreSQL with DiskANN: # HINDSIGHT_API_VECTOR_EXTENSION=pgvectorscale # Auto-detects pg_diskann on Azure # Embeddings Configuration (Optional - uses local by default) # Provider: "local" (default) or "tei" (HuggingFace Text Embeddings Inference) # HINDSIGHT_API_EMBEDDINGS_PROVIDER=local # For local provider: # HINDSIGHT_API_EMBEDDINGS_LOCAL_MODEL=BAAI/bge-small-en-v1.5 # For TEI provider: # HINDSIGHT_API_EMBEDDINGS_TEI_URL=http://localhost:8080 # Reranker Configuration (Optional - uses local by default) # Provider: "local" (default) or "tei" (HuggingFace Text Embeddings Inference) # HINDSIGHT_API_RERANKER_PROVIDER=local # For local provider: # HINDSIGHT_API_RERANKER_LOCAL_MODEL=cross-encoder/ms-marco-MiniLM-L-6-v2 # For TEI provider: # HINDSIGHT_API_RERANKER_TEI_URL=http://localhost:8081 # Observability & Tracing (Optional - disabled by default) # Enable OpenTelemetry tracing for LLM calls (GenAI semantic conventions) # HINDSIGHT_API_OTEL_TRACES_ENABLED=true # # Local development with Grafana LGTM stack (recommended - see scripts/dev/grafana/README.md) # HINDSIGHT_API_OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 # # Cloud backends (Grafana Cloud, Langfuse, DataDog, etc.) # HINDSIGHT_API_OTEL_EXPORTER_OTLP_ENDPOINT=https://your-backend-url # HINDSIGHT_API_OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token" # # Custom service name and environment (optional, defaults: hindsight-api, development) # HINDSIGHT_API_OTEL_SERVICE_NAME=hindsight-production # HINDSIGHT_API_OTEL_DEPLOYMENT_ENVIRONMENT=production