.env.example

# Solace — AI Companion Framework
# ================================
# Copy this file to .env and fill in your values.

# --- Required ---

# OpenRouter API key (https://openrouter.ai — for LLM inference)
OPENROUTER_API_KEY=your-openrouter-api-key-here

# Default model for chat (OpenRouter model ID)
DEFAULT_MODEL=qwen/qwen3-235b-a22b

# --- Authentication ---

# JWT secret for API authentication
# Generate with: python3 -c "import secrets; print(secrets.token_hex(32))"
AMARIN_JWT_SECRET=generate-a-random-hex-string-here

# Password hash for login
# Generate with: python3 -c "import bcrypt; print(bcrypt.hashpw(b'your-password', bcrypt.gensalt()).decode())"
# IMPORTANT: In Docker Compose .env files, escape $ as $$ (e.g., $$2b$$12$$...)
AMARIN_PASSWORD_HASH=generate-bcrypt-hash-here

# Service token for background services like Watchman
# Generate with: python3 -c "import secrets; print(secrets.token_hex(32))"
AMARIN_SERVICE_TOKEN=generate-a-random-hex-string-here

# Allowed CORS origins (comma-separated)
AMARIN_ALLOWED_ORIGINS=http://localhost,http://localhost:3000,http://127.0.0.1

# --- Optional ---

# Hugging Face token (for downloading gated models)
# HF_TOKEN=your-huggingface-token-here

# Frontend bind address (default: 0.0.0.0, restrict to specific IP for security)
# FRONTEND_BIND=0.0.0.0

# --- CMS (optional, for companion blogging) ---

# Directus CMS
# DIRECTUS_URL=http://localhost:8055
# DIRECTUS_TOKEN=your-directus-static-token-here