dffb87080f
* fix(migrations): use HINDSIGHT_API_MIGRATION_DATABASE_URL when set Session-level advisory locks are broken when the database URL goes through PgBouncer in transaction mode: the backend connection is returned to the pool on COMMIT, orphaning the lock, so multiple pods can simultaneously run migrations for the same schema. When HINDSIGHT_API_MIGRATION_DATABASE_URL is set, use it for both the advisory lock connection and the Alembic run. Callers should point this at the direct PostgreSQL endpoint (bypassing the pooler) so the session-level lock is held for the full migration duration. * refactor(migrations): move MIGRATION_DATABASE_URL to standard config Wire HINDSIGHT_API_MIGRATION_DATABASE_URL through HindsightConfig instead of reading os.getenv() directly in migrations.py. Add the field to the dataclass, from_env(), log_config(), all call sites, .env.example, and the configuration docs page. * fix: update test mocks for migration_database_url kwarg and regenerate docs skill --------- Co-authored-by: Nicolò Boschi <boschi1997@gmail.com>
85 lines
3.7 KiB
Text
85 lines
3.7 KiB
Text
# 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, volcano
|
|
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 (1M context window)
|
|
# HINDSIGHT_API_LLM_PROVIDER=minimax
|
|
# HINDSIGHT_API_LLM_API_KEY=your-minimax-api-key
|
|
# HINDSIGHT_API_LLM_MODEL=MiniMax-M2.7
|
|
|
|
# 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_MIGRATION_DATABASE_URL= # Direct PostgreSQL URL for migrations (bypasses PgBouncer). Falls back to DATABASE_URL.
|
|
# 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
|