env.example

#######################################################################
# KillrVideo v2 – FastAPI Backend
# Example environment-variable file
#
# Copy to `.env` and replace placeholder values for a working setup.
# NOTE: never commit your real `.env` to source control!
#######################################################################

# --------------------------------------------------------------------
# Application runtime
# --------------------------------------------------------------------
# Override build/version shown in /docs.  Leave blank to use package metadata.
APP_VERSION=2.0.0-alpha-local

# Comma-separated list of origins allowed by CORS middleware.
# Example: http://localhost:3000,https://my-frontend.app
CORS_ALLOW_ORIGINS=*

# --------------------------------------------------------------------
# DataStax Astra DB
# --------------------------------------------------------------------
# Your REST endpoint, something like:
#   https://<db-id>-<region>.apps.astra.datastax.com/api/json/v1
ASTRA_DB_API_ENDPOINT=https://replace-me.apps.astra.datastax.com/api/json/v1

# Token generated in the Astra UI (Organization → Tokens).
ASTRA_DB_APPLICATION_TOKEN=astraCS:REPLACE_ME

# Logical keyspace to use (create one named "killrvideo" for tutorials).
ASTRA_DB_KEYSPACE=killrvideo

# --------------------------------------------------------------------
# JWT / Auth
# --------------------------------------------------------------------
# 32-char (min) random secret key used to sign JWTs.
SECRET_KEY=please-change-me-to-a-long-random-string

# Algorithm is hard-coded in settings but can be overridden if needed.
# ALGORITHM=HS256

# Access-token lifetime (minutes). 30 by default.
# ACCESS_TOKEN_EXPIRE_MINUTES=30

# --------------------------------------------------------------------
# Feature Flags
# --------------------------------------------------------------------
# Enable semantic vector search using IBM Granite embeddings (true/false).
# Default is true. Set to false if you haven't loaded vector embeddings yet.
VECTOR_SEARCH_ENABLED=true

# Minimum similarity score (0.0-1.0) for semantic search results
# Higher values = more strict matching (fewer but more relevant results)
# Lower values = more lenient matching (more results but potentially less relevant)
# Recommended range: 0.5-0.8 for Granite embeddings. Default: 0.65
# VECTOR_SEARCH_SIMILARITY_THRESHOLD=0.65

# --------------------------------------------------------------------
# Observability / Telemetry
# --------------------------------------------------------------------
# Enable or disable all observability integrations (Prometheus, OpenTelemetry, Loki).
OBSERVABILITY_ENABLED=true

# --- OpenTelemetry (Traces & Metrics) --------------------------------
# Base OTLP endpoint; for local docker-compose stack use http://localhost:4318
OTEL_EXPORTER_OTLP_ENDPOINT=http://replace-me:4318
# OTLP protocol (grpc|http) – default grpc
OTEL_EXPORTER_OTLP_PROTOCOL=grpc

# Extra OTLP headers – comma separated key=value pairs
# OTEL_EXPORTER_OTLP_HEADERS=mcp-token=REPLACE_ME_TOKEN

# Toggle traces / metrics export (true/false)
OTEL_TRACES_ENABLED=true
OTEL_METRICS_ENABLED=false

# --- Loki -------------------------------------------------------------
# Ship structured logs to Loki. Ensure logging-loki & python-json-logger installed.
# When disabled or unavailable, logs are written to rotating files under ./logs.
# LOKI_ENABLED=false
# LOKI_ENDPOINT=http://loki:3100/loki/api/v1/push
# LOKI_EXTRA_LABELS=team=backend,feature=killrvideo

#######################################################################
# End of file
#######################################################################