.env.example

# Required: set the primary model LumaKit should use through Ollama.
# Recommended:
# - if your Ollama setup exposes strong cloud-backed models, use one for the
#   best first-run tool quality
# - if you want the fully local/private path, point this at a local model
OLLAMA_MODEL="your-model-here"

# Optional fallback if the primary is unavailable or overloaded
OLLAMA_FALLBACK_MODEL=""

# Optional local model that the Telegram owner can toggle on with `/model local on`
OLLAMA_LOCAL_MODEL=""

# Examples of the kind of models that work well with this repo:
# OLLAMA_MODEL="glm-5:cloud"
# OLLAMA_MODEL="qwen3"
# OLLAMA_MODEL="llama3.3"
# OLLAMA_FALLBACK_MODEL="gemma3:4b"

# Serp API for premium web search capabilities.
SERPAPI_KEY="Your API key here"

# Telegram bot (create via @BotFather on Telegram)
TELEGRAM_BOT_TOKEN="Your bot token here"
# Comma-separated chat IDs — first is the owner/admin
TELEGRAM_ALLOWED_IDS="your_id,spouse_id,kid_id"

# Optional local Telegram speech settings.
# whisper.cpp handles STT locally, and edge-tts handles outgoing voice replies.
LUMIKIT_WHISPER_DIR=".vendor/whisper.cpp"
LUMIKIT_WHISPER_BIN=".vendor/whisper.cpp/build/bin/whisper-cli"
LUMIKIT_WHISPER_MODEL=".vendor/whisper.cpp/models/ggml-base.en.bin"
LUMIKIT_TTS_VOICE="en-US-AvaNeural"
LUMIKIT_TTS_FORMAT="mp3"

# Lumi's own email account (Gmail recommended — use an App Password)
# Generate one at https://myaccount.google.com/apppasswords
# Email tools are owner-only (only the first TELEGRAM_ALLOWED_IDS can trigger them)
LUMI_EMAIL_ADDRESS=
LUMI_EMAIL_PASSWORD=
LUMI_EMAIL_SMTP_HOST="smtp.gmail.com"
LUMI_EMAIL_SMTP_PORT="465"
LUMI_EMAIL_IMAP_HOST="imap.gmail.com"
LUMI_EMAIL_IMAP_PORT="993"
# Signature appended to every outbound email
LUMI_EMAIL_SIGNATURE="Lumi - official LumaKit agent"
# Max emails Lumi can send per rolling 1-hour window (safety cap)
LUMI_EMAIL_MAX_PER_HOUR="10"