.env.example

# memory-hall — example environment
# Fields mirror pydantic Settings in src/memory_hall/config.py (env_prefix="MH_").

# Server
MH_HOST=0.0.0.0
MH_PORT=9000
MH_API_BASE_URL=http://127.0.0.1:9000

# Storage (SQLite, WAL mode)
MH_DATABASE_PATH=/data/memory-hall.sqlite3
MH_VECTOR_DATABASE_PATH=/data/memory-hall-vectors.sqlite3
MH_VECTOR_DIM=1024

# Embedder (Ollama, bge-m3 by default)
MH_OLLAMA_BASE_URL=http://localhost:11434
MH_OLLAMA_MODEL=bge-m3
MH_EMBED_TIMEOUT_S=2.0

# Tenant
MH_DEFAULT_TENANT_ID=default

# Auth (optional, minimal-token mode). Leave unset for dev/standalone.
# When set, every request except GET /v1/health requires:
#   Authorization: Bearer <value>
# Generate with: openssl rand -hex 32
# MH_API_TOKEN=

# Admin gate (optional, two-tier bearer). See ADR 0009.
# When set, /v1/admin/* requires this token; the regular MH_API_TOKEN is
# rejected on admin paths. When unset, /v1/admin/* falls back to MH_API_TOKEN
# (backward compat). Use a different value from MH_API_TOKEN.
# MH_ADMIN_TOKEN=

# Request behavior
MH_REQUEST_TIMEOUT_S=5.0
MH_LIST_DEFAULT_LIMIT=50
MH_SEARCH_DEFAULT_LIMIT=20
MH_SEARCH_CANDIDATE_MULTIPLIER=5
MH_REINDEX_BATCH_SIZE=500