# =============================================================================
# VIKI - Copy this file to .env and set your own values.
# Never commit .env. This file is safe to commit as a template.
# =============================================================================

# --- Required for API server (optional for CLI) ---
VIKI_API_KEY=
# Generate: python -c "import secrets; print(secrets.token_urlsafe(32))"

# --- Required for admin / super-admin commands ---
VIKI_ADMIN_SECRET=
# Generate: python -c "import secrets; print(secrets.token_urlsafe(32))"

# --- Paths (use so paths are not tied to a specific user/machine) ---
# Data directory: DBs, lessons, sessions, logs. Default: ./data
VIKI_DATA_DIR=./data
# Workspace directory: files VIKI can read/write. Default: ./workspace
VIKI_WORKSPACE_DIR=./workspace

# --- Optional: append JSONL usage (LLM/skills) to data_dir/usage_session.jsonl (default on in settings.yaml) ---
# VIKI_SESSION_USAGE_LOG=false

# --- Persona (sovereign | dev | research | home) ---
VIKI_PERSONA=sovereign

# --- Optional: run in shadow mode (simulate only) or air-gap (no external APIs) ---
# VIKI_SHADOW_MODE=false
# VIKI_AIR_GAP=false

# --- Optional: auto web search when the reply looks uncertain (1/true/on or 0/false/off). Off in air-gap/shadow. ---
# VIKI_AUTO_WEB_RESEARCH=true

# --- Optional: min lesson access_count for training JSONL export (default 2). Set 1 to include single-hit lessons. ---
# VIKI_LESSON_EXPORT_MIN_ACCESS=2

# --- Optional: background web ingest + Modelfile bake after VIKI starts (see forge.background_evolution_at_boot). ---
# VIKI_BACKGROUND_EVOLUTION_AT_BOOT=true

# --- Headless boot worker: force one evolution cycle even if YAML flag is false (use with Task Scheduler). ---
# VIKI_BOOT_EVOLVE_FORCE=1

# --- Skip full startup pulse when using scripts/viki_headless_boot_evolve.py (set automatically by that script). ---
# VIKI_SKIP_STARTUP_PULSE=1

# --- Optional: local endpoint guard (heuristic download watcher; complements OS antivirus). 1=on, 0=off. ---
# VIKI_ENDPOINT_GUARD=1

# --- Optional: embedding and voice on GPU ---
# VIKI_EMBED_GPU=0
# VIKI_VAD_GPU=0

# --- Optional: BioModule webcam (OpenCV). Leave unset/false on PCs without a camera to avoid MSMF warnings. ---
# VIKI_BIO_WEBCAM=0

# --- Local LM Studio: Neural Forge Modelfile `FROM` (must match LM Studio model name) ---
# VIKI_FORGE_BASE_LMSTUDIO_MODEL=google/gemma-4-e4b # Set the desired base model here

# --- Optional LoRA (Unsloth + CUDA): export is always done; training runs only when set to true ---
# VIKI_UNSLOTH_RUN_TRAIN=0
# VIKI_UNSLOTH_BASE_MODEL=unsloth/Qwen2.5-3B-Instruct-bnb-4bit

# --- Optional: LLM API keys (for cloud fallbacks) ---
# OPENAI_API_KEY=
# ANTHROPIC_API_KEY=
# NVIDIA_API_KEY=        # NVIDIA NIM: get a free key at https://build.nvidia.com (starts with nvapi-)
#                        # Unlocks: Llama Nemotron Ultra 253B, DeepSeek-R1, Llama 3.1 8B fast, embedding models
# OPENCODE_API_KEY=    # OpenCode: get a key at https://opencode.ai (starts with sk-)
#                        # Unlocks: Zen and Go coding/reasoning models (GPT-5.5, Qwen 3.7 Plus) for VIKI's self-improvement pipeline

# --- Optional: Flask (API server) ---
# FLASK_DEBUG=False

# --- Optional: integrations (paths to credential JSON files) ---
# VIKI_GMAIL_CREDENTIALS_PATH=
# VIKI_GOOGLE_CALENDAR_CREDENTIALS_PATH=
# VIKI_OBSIDIAN_VAULT=

# --- Optional: messaging / bridges ---
# TELEGRAM_BOT_TOKEN=
# DISCORD_TOKEN=
# SLACK_BOT_TOKEN=
# SLACK_APP_TOKEN=
# SLACK_USER_TOKEN=
# WHATSAPP_TOKEN=
# Twilio (WhatsApp): TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, WHATSAPP_PHONE_NUMBER

# --- Optional: other skills ---
# VIKI_TWITTER_BEARER_TOKEN=
# VIKI_TWITTER_API_KEY=
# VIKI_TWITTER_API_SECRET=
# VIKI_ELEVENLABS_API_KEY=
# VIKI_ELEVENLABS_VOICE_ID=
# VIKI_HUE_BRIDGE_IP=
# VIKI_HUE_USER=
# VIKI_GIPHY_API_KEY=
# VIKI_INTERPRETER_TIMEOUT=30
# VIKI_VOICE_ENABLED=1             # Set to 0 to disable sounddevice/voice features

# --- Optional: CORS (API server, comma-separated origins) ---
# VIKI_CORS_ORIGINS=

# --- Optional: Hugging Face (fewer rate limits for sentence-transformers) ---
# HF_TOKEN=