.env.example

# ========================================
# SANCTUARY CONFIGURATION
# ========================================

# REQUIRED: Your Google API Key
# Get one free at: https://aistudio.google.com/apikey
GOOGLE_API_KEY=YOUR_GOOGLE_API_KEY_HERE

# VOICE: Works out of the box with edge-tts (free, no key needed)
# Pick a voice that fits your companion's personality.
#
# Female voices:
#   en-US-AriaNeural        — Warm, conversational, versatile (default)
#   en-US-JennyNeural       — Friendly, clear, natural
#   en-GB-SoniaNeural       — British, composed, elegant
#   en-AU-NatashaNeural     — Australian, bright, approachable
#
# Male voices:
#   en-US-AndrewMultilingualNeural — Warm, natural, multilingual
#   en-US-BrianMultilingualNeural  — Smooth, expressive, multilingual
#   en-GB-RyanNeural        — British, deep, grounded
#   en-AU-WilliamNeural     — Australian, relaxed, easygoing
#
# 300+ voices available in 74 languages (Japanese, Spanish, French, German, etc.)
# Preview them all at: https://tts.travisvn.com
EDGE_TTS_VOICE=en-US-AriaNeural

# OPTIONAL: ElevenLabs API Key (premium voice upgrade)
# Get one at: https://elevenlabs.io
# If set, ElevenLabs will be used instead of edge-tts
ELEVENLABS_API_KEY=
ELEVENLABS_VOICE_ID=

# Password to access Sanctuary (protects against others on your network)
# Change this to something only you know. Leave empty to disable.
SANCTUARY_PASSWORD=sanctuary

# Your timezone (for scheduling and timestamps)
# See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
TIMEZONE=UTC

# APPEARANCE — Make it yours
# Drop an image in static/ and point to it here
COMPANION_AVATAR=
# Example: COMPANION_AVATAR=static/avatar.jpg
CHAT_BACKGROUND=
# Example: CHAT_BACKGROUND=static/background.jpg

# Don't change these unless you know what you're doing
FLASK_PORT=5000
TEMPERATURE=1.1
MAX_TOKENS=4000
MAX_TOKENS_REASONER=16000