.env.example

# Starshard memory hub — Phase 0 reference implementation env vars

# --- hub server ---
# Bearer token for API auth. Generate with: python -c 'import secrets; print(secrets.token_urlsafe(32))'
# Agents set this in their MCP client config; the server validates on every request.
HUB_API_TOKEN=change-me-to-a-long-random-string

# SQLite file path (inside container / host). Auto-created on first boot.
HUB_DB_PATH=/data/hub.sqlite

# Listen address + port.
HUB_HOST=0.0.0.0
HUB_PORT=8080

# Optional: maximum memory record content length (bytes). Default 200KB.
HUB_MAX_CONTENT_BYTES=204800

# Optional: default list_memories limit. Default 20.
HUB_DEFAULT_LIMIT=20

# --- scripts/mirror.py and scripts/digest.py (optional) ---
# These scripts read from the hub over HTTP and call the Anthropic API.
# They run as cron/systemd/launchd jobs on the hub host — not inside the container.
# Skip these variables if you are only running the hub server.

# Hub URL from the script's perspective (typically http://localhost:8080 if on same host).
STARSHARD_HUB_URL=http://localhost:8080
STARSHARD_HUB_TOKEN=${HUB_API_TOKEN}

# Anthropic API key. Get one at https://console.anthropic.com/settings/keys
ANTHROPIC_API_KEY=

# Mirror (nightly consolidation)
MIRROR_MODEL=claude-sonnet-4-6
MIRROR_WINDOW_HOURS=24
MIRROR_MAX_RECORDS=200

# Digest (weekly email)
DIGEST_MODEL=claude-sonnet-4-6
DIGEST_WINDOW_DAYS=7
DIGEST_SUBJECT_PREFIX=[Starshard Weekly]
DIGEST_TO=you@example.com

# SMTP for digest email delivery. Gmail app password works fine.
SMTP_HOST=smtp.gmail.com
SMTP_PORT=465
SMTP_USER=you@example.com
SMTP_PASS=