.env.sample

# =============================================================================
# Memory Engine Server — Environment Variables
# =============================================================================
# Copy to .env and fill in the required values.

# -----------------------------------------------------------------------------
# Required
# -----------------------------------------------------------------------------

# PostgreSQL connection string for the accounts database
# (stores identities, orgs, engines, sessions, API keys)
ACCOUNTS_DATABASE_URL=postgres://postgres:postgres@localhost:5432/me

# 32-byte hex key for encrypting API keys at rest
# Generate with: openssl rand -hex 32
ACCOUNTS_MASTER_KEY=

# PostgreSQL connection string for the engine database
# (stores memories — each engine gets its own schema)
ENGINE_DATABASE_URL=postgres://postgres:postgres@localhost:5432/me

# Public base URL for OAuth callbacks
API_BASE_URL=http://localhost:3000

# OpenAI API key (or compatible provider) for generating embeddings
EMBEDDING_API_KEY=

# -----------------------------------------------------------------------------
# OAuth Providers
# -----------------------------------------------------------------------------
# At least one provider is required for user authentication.

# GitHub OAuth app credentials
# Create at: https://github.com/settings/developers
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=

# Google OAuth app credentials
# Create at: https://console.cloud.google.com/apis/credentials
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# -----------------------------------------------------------------------------
# Optional — Server
# -----------------------------------------------------------------------------

# HTTP server port
# PORT=3000

# Schema name in the accounts database
# ACCOUNTS_SCHEMA=accounts

# Cron schedule for cleaning up expired device authorizations (UTC)
# DEVICE_FLOW_CLEANUP_CRON=*/15 * * * *

# -----------------------------------------------------------------------------
# Optional — Embedding
# -----------------------------------------------------------------------------

# Base URL for the embedding API (omit for OpenAI default)
# EMBEDDING_BASE_URL=

# Timeout per embedding API call (ms)
# EMBEDDING_TIMEOUT_MS=

# Max retries on transient failures (default: 2, from Vercel AI SDK)
# EMBEDDING_MAX_RETRIES=

# Max concurrent chunk requests for batch embedding (default: Infinity)
# EMBEDDING_MAX_PARALLEL_CALLS=

# -----------------------------------------------------------------------------
# Optional — Telemetry
# -----------------------------------------------------------------------------

# Logfire token for OpenTelemetry export (omit to disable)
# LOGFIRE_TOKEN=

# LOGFIRE_ENVIRONMENT=prod

# Print spans to console (useful for local development)
# LOGFIRE_CONSOLE=true

# Disable scrubbing of sensitive fields (content, embeddings, tokens)
# LOGFIRE_SCRUBBING=false

# -----------------------------------------------------------------------------
# Optional — Accounts Database Connection Pool
# -----------------------------------------------------------------------------

# Maximum connections in pool
# ACCOUNTS_POOL_MAX=10

# Close idle connections after N seconds
# ACCOUNTS_POOL_IDLE_TIMEOUT=30

# Max connection lifetime in seconds (0 = forever)
# ACCOUNTS_POOL_MAX_LIFETIME=0

# Timeout for establishing new connections (seconds)
# ACCOUNTS_POOL_CONNECTION_TIMEOUT=30

# -----------------------------------------------------------------------------
# Optional — Engine Database Connection Pool
# -----------------------------------------------------------------------------

# Maximum connections in pool
# ENGINE_POOL_MAX=20

# Close idle connections after N seconds
# ENGINE_POOL_IDLE_TIMEOUT=30

# Max connection lifetime in seconds (0 = forever)
# ENGINE_POOL_MAX_LIFETIME=0

# Timeout for establishing new connections (seconds)
# ENGINE_POOL_CONNECTION_TIMEOUT=30

# -----------------------------------------------------------------------------
# Optional — Embedding Worker
# -----------------------------------------------------------------------------

# Number of concurrent embedding workers
# WORKER_COUNT=2

# Queue entries to claim per batch
# WORKER_BATCH_SIZE=10

# PostgreSQL interval for claim lock duration
# WORKER_LOCK_DURATION=5 minutes

# Poll interval when idle (ms)
# WORKER_IDLE_DELAY_MS=10000

# Max error backoff (ms)
# WORKER_MAX_BACKOFF_MS=60000

# Engine re-discovery interval (ms)
# WORKER_REFRESH_INTERVAL_MS=60000