.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

# Maximum request body size in bytes (default: 1048576 = 1 MiB).
# Raise for memory.batchCreate-heavy workloads (e.g. transcript imports).
# MAX_REQUEST_BODY_BYTES=

# Schema name in the accounts database
# ACCOUNTS_SCHEMA=accounts

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

# -----------------------------------------------------------------------------
# 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 pooled connections after N seconds
# ACCOUNTS_POOL_IDLE_REAP_SECONDS=300

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

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

# PostgreSQL statement timeout for accounts DB transactions
# ACCOUNTS_STATEMENT_TIMEOUT=25s

# PostgreSQL lock wait timeout for accounts DB transactions
# ACCOUNTS_LOCK_TIMEOUT=5s

# PostgreSQL transaction timeout for accounts DB transactions
# ACCOUNTS_TRANSACTION_TIMEOUT=30s

# PostgreSQL idle-in-transaction timeout for accounts DB transactions
# ACCOUNTS_IDLE_IN_TRANSACTION_SESSION_TIMEOUT=30s

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

# Maximum connections in pool
# ENGINE_POOL_MAX=20

# Close idle pooled connections after N seconds
# ENGINE_POOL_IDLE_REAP_SECONDS=300

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

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

# PostgreSQL statement timeout for engine DB transactions
# ENGINE_STATEMENT_TIMEOUT=25s

# PostgreSQL lock wait timeout for engine DB transactions
# ENGINE_LOCK_TIMEOUT=5s

# PostgreSQL transaction timeout for engine DB transactions
# ENGINE_TRANSACTION_TIMEOUT=30s

# PostgreSQL idle-in-transaction timeout for engine DB transactions
# ENGINE_IDLE_IN_TRANSACTION_SESSION_TIMEOUT=30s

# -----------------------------------------------------------------------------
# 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 — 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

# -----------------------------------------------------------------------------
# Optional — Embedding Worker Engine Database
# -----------------------------------------------------------------------------

# PostgreSQL connection string for embedding worker engine traffic.
# Defaults to ENGINE_DATABASE_URL when unset.
# WORKER_ENGINE_DATABASE_URL=postgres://postgres:postgres@localhost:5432/me

# Maximum connections in the dedicated embedding worker engine pool.
# Defaults to max(WORKER_COUNT, 1) when unset.
# WORKER_ENGINE_POOL_MAX=2

# Close idle embedding worker engine connections after N seconds.
# Defaults to ENGINE_POOL_IDLE_REAP_SECONDS when unset.
# WORKER_ENGINE_POOL_IDLE_REAP_SECONDS=300

# Max embedding worker engine connection lifetime in seconds (0 = forever).
# Defaults to ENGINE_POOL_MAX_LIFETIME when unset.
# WORKER_ENGINE_POOL_MAX_LIFETIME=0

# Timeout for establishing embedding worker engine connections (seconds).
# Defaults to ENGINE_POOL_CONNECTION_TIMEOUT when unset.
# WORKER_ENGINE_POOL_CONNECTION_TIMEOUT=30

# PostgreSQL statement timeout for embedding worker engine DB transactions
# Defaults to ENGINE_STATEMENT_TIMEOUT when unset.
# WORKER_ENGINE_STATEMENT_TIMEOUT=25s

# PostgreSQL lock wait timeout for embedding worker engine DB transactions
# Defaults to ENGINE_LOCK_TIMEOUT when unset.
# WORKER_ENGINE_LOCK_TIMEOUT=5s

# PostgreSQL transaction timeout for embedding worker engine DB transactions
# Defaults to ENGINE_TRANSACTION_TIMEOUT when unset.
# WORKER_ENGINE_TRANSACTION_TIMEOUT=30s

# PostgreSQL idle-in-transaction timeout for embedding worker engine DB transactions
# Defaults to ENGINE_IDLE_IN_TRANSACTION_SESSION_TIMEOUT when unset.
# WORKER_ENGINE_IDLE_IN_TRANSACTION_SESSION_TIMEOUT=30s