.env.example

# Causantic Environment Variables
# Copy to .env and fill in your values. All are optional — defaults work out of the box.

# ── API Keys ──────────────────────────────────────────────────
# Anthropic API key (for cluster label refresh via Haiku).
# Preferred: store in keychain with `causantic config set-key <key>`
# ANTHROPIC_API_KEY=sk-ant-...

# ── Storage ───────────────────────────────────────────────────
# CAUSANTIC_STORAGE_DB_PATH=~/.causantic/memory.db
# CAUSANTIC_STORAGE_VECTOR_PATH=~/.causantic/vectors

# ── Encryption ────────────────────────────────────────────────
# CAUSANTIC_ENCRYPTION_ENABLED=false
# CAUSANTIC_ENCRYPTION_CIPHER=chacha20        # chacha20 | sqlcipher
# CAUSANTIC_ENCRYPTION_KEY_SOURCE=keychain    # keychain | env | prompt
# CAUSANTIC_ENCRYPTION_AUDIT_LOG=false
# CAUSANTIC_DB_KEY=                           # Only if key_source=env
# CAUSANTIC_EXPORT_PASSWORD=                  # For encrypted export/import

# ── Clustering ────────────────────────────────────────────────
# CAUSANTIC_CLUSTERING_THRESHOLD=0.1
# CAUSANTIC_CLUSTERING_MIN_CLUSTER_SIZE=4

# ── Traversal ─────────────────────────────────────────────────
# CAUSANTIC_TRAVERSAL_MAX_DEPTH=50

# ── Token Budgets ─────────────────────────────────────────────
# CAUSANTIC_TOKENS_CLAUDE_MD_BUDGET=500
# CAUSANTIC_TOKENS_MCP_MAX_RESPONSE=20000

# ── LLM (cluster labeling) ───────────────────────────────────
# CAUSANTIC_LLM_CLUSTER_REFRESH_MODEL=claude-3-haiku-20240307
# CAUSANTIC_LLM_REFRESH_RATE_LIMIT=30
# CAUSANTIC_LLM_ENABLE_LABELLING=true              # Enable LLM-based cluster labelling (requires API key)

# ── Vectors ───────────────────────────────────────────────────
# CAUSANTIC_VECTORS_TTL_DAYS=90
# CAUSANTIC_VECTORS_MAX_COUNT=0

# ── Retrieval ───────────────────────────────────────────────
# CAUSANTIC_RETRIEVAL_PRIMARY=hybrid           # keyword | vector | hybrid (BM25+vector+RRF)
# CAUSANTIC_RETRIEVAL_VECTOR_ENRICHMENT=false  # Enrich keyword results with vector search (when primary=keyword)

# ── Embedding ─────────────────────────────────────────────────
# CAUSANTIC_EMBEDDING_DEVICE=                 # auto-detected (gpu/cpu)
# CAUSANTIC_EMBEDDING_EAGER=false             # Embed chunks during ingestion (false = deferred)

# ── Semantic Index ──────────────────────────────────────────
# CAUSANTIC_SEMANTIC_INDEX_ENABLED=false       # Enable jeopardy-style semantic index (requires eager embedding)
# CAUSANTIC_SEMANTIC_INDEX_USE_FOR_SEARCH=true # Use semantic index descriptions in search results

# ── Maintenance ───────────────────────────────────────────────
# CAUSANTIC_MAINTENANCE_CLUSTER_HOUR=2        # Hour of day (0-23) for reclustering

# ── MCP Server ────────────────────────────────────────────────
# CAUSANTIC_MCP_LOGGING=false
# CAUSANTIC_MCP_LOG_LEVEL=info                # debug | info | warn | error
# CAUSANTIC_MCP_AUTH_TOKEN=                   # For network deployments

# ── Logging ───────────────────────────────────────────────────
# CAUSANTIC_LOG_LEVEL=info                    # debug | info | warn | error
# CAUSANTIC_LOG_JSON=false

# ── Hooks ─────────────────────────────────────────────────────
# CAUSANTIC_HOOK_LOGGING=false
# CAUSANTIC_HOOK_LOG_LEVEL=info

# ── Secrets ───────────────────────────────────────────────────
# CAUSANTIC_SECRET_PASSWORD=                  # Fallback for secret store on Linux