.env.example

# Required: AI providers (OPENAI_API_KEY not needed when GENESYS_EMBEDDER=local)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

# Storage backend: memory | postgres | obsidian | falkordb
# "memory"   = zero-dependency in-memory store (good for trying it out)
# "postgres"  = Postgres + pgvector (production)
# "obsidian"  = Obsidian vault (local-first, pip install genesys-memory[obsidian])
# "falkordb"  = FalkorDB graph database (pip install genesys-memory[falkordb])
GENESYS_BACKEND=memory

# Embedding provider: openai | local
# "openai" = OpenAI text-embedding-3-small (1536-dim, requires OPENAI_API_KEY)
# "local"  = sentence-transformers all-MiniLM-L6-v2 (384-dim, no API key needed)
#            pip install genesys-memory[local]
GENESYS_EMBEDDER=openai

# Persist path for in-memory backend (saves state across restarts)
# GENESYS_PERSIST_PATH=.genesys_state.json

# Postgres (required when GENESYS_BACKEND=postgres)
DATABASE_URL=postgresql://genesys:genesys@localhost:5432/genesys

# Obsidian (required when GENESYS_BACKEND=obsidian)
# OBSIDIAN_VAULT_PATH=/path/to/your/vault

# FalkorDB (required when GENESYS_BACKEND=falkordb)
# FALKORDB_HOST=localhost

# Default user ID (used in single-tenant / dev mode)
GENESYS_USER_ID=default_user

# Public URL for MCP OAuth (set to your domain in production)
GENESYS_PUBLIC_URL=http://localhost:8000

# CORS origins (comma-separated, for production UI domain)
# CORS_ORIGINS=https://your-ui.example.com

# Clerk auth (optional — auto-approve dev mode when not set)
# CLERK_SECRET_KEY=sk_live_...
# CLERK_PUBLISHABLE_KEY=pk_live_...
# CLERK_JWKS_URL=https://your-clerk-domain/.well-known/jwks.json
# CLERK_DOMAIN=your-clerk-domain.clerk.accounts.dev
# CLERK_USER_ID=user_...  # Required for seed_demo.py and seed_recalls.py

# UI URL (for OAuth redirects)
# GENESYS_UI_URL=http://localhost:3000

# Security overrides (for local dev / benchmarks)
# GENESYS_DEV_MODE=true          # Enables x-user-id header bypass, relaxes admin auth
# GENESYS_BYPASS_RATE_LIMITS=true # Disables all rate limiting
# GENESYS_ADMIN_API_KEY=          # Required in production for /admin/* and /backfill-edges

# Rate limits (requests per minute, per user)
# GENESYS_RATE_LIMIT_GENERAL=60   # Store, recall, search, etc.
# GENESYS_RATE_LIMIT_ADMIN=5      # Admin endpoints

# Engine thresholds (all have sensible defaults — only override if tuning)
# See src/genesys/engine/config.py for full list and documentation
# GENESYS_ACTR_DECAY=0.5                       # ACT-R decay exponent (d parameter)
# GENESYS_RELEVANCE_VECTOR_WEIGHT=0.7           # Vector similarity weight in relevance
# GENESYS_RELEVANCE_KEYWORD_WEIGHT=0.3          # Keyword overlap weight in relevance
# GENESYS_MIN_CONNECTIVITY=0.1                  # Floor for connectivity factor
# GENESYS_TAGGED_EXPIRE_HOURS=24                # Hours before orphan tagged nodes expire
# GENESYS_ACTIVE_EPISODIC_THRESHOLD=0.6         # Decay score below this increments counter
# GENESYS_ACTIVE_EPISODIC_SESSIONS=3            # Consecutive low-score sessions to downgrade
# GENESYS_DORMANCY_THRESHOLD=0.15               # Decay score threshold for dormancy
# GENESYS_DORMANCY_DAYS=90                      # Days inactive before dormancy eligible
# GENESYS_DORMANCY_MAX_REACTIVATIONS=3          # Max reactivations allowed for dormancy
# GENESYS_FORGETTING_THRESHOLD=0.01             # Decay score floor for forgetting
# GENESYS_CORE_THRESHOLD=0.55                   # Consolidation score for core promotion
# GENESYS_CORE_ACTIVATION_WEIGHT=0.4            # Activation weight in consolidation score
# GENESYS_CORE_HUB_WEIGHT=0.3                   # Hub importance weight
# GENESYS_CORE_SCHEMA_WEIGHT=0.2                # Schema match weight
# GENESYS_CORE_STABILITY_WEIGHT=0.1             # Stability weight
# GENESYS_AUTO_PROMOTE_CATEGORIES=professional,educational,family,location
# GENESYS_CASCADE_DEPTH=2                       # Max hops for spreading activation
# GENESYS_CASCADE_DECAY_FACTOR=0.3              # Decay per hop in cascade
# GENESYS_MAX_INGEST_FILE_MB=100                # Max file size for conversation imports