.env.example version 3

# =============================================================================
# J.A.R.V.I.S — Environment Variables (Full Control)
# =============================================================================
# Copy this file to .env and fill in your values. Never commit .env to git.
# All settings below are optional except GROQ_API_KEY (required for chat).
# =============================================================================


# ==============================
# GROQ API (Required for chat)
# ==============================
# Get your key at https://console.groq.com
# You can use multiple Groq API keys: set GROQ_API_KEY_2, GROQ_API_KEY_3, etc.
# for automatic fallback when the primary key fails (rate limit or timeout).
# Primary key — used first for every request.

GROQ_API_KEY=your_groq_api_key_here


# ==============================
# GROQ Fallback Keys (Optional)
# ==============================
# Multiple Groq API keys: if the primary key fails, these are tried in order.
# Each key has its own daily limit on the free tier, so more keys = more capacity.

# GROQ_API_KEY_2=your_second_key_here
# GROQ_API_KEY_3=your_third_key_here
# GROQ_API_KEY_4=your_fourth_key_here


# ==============================
# GROQ Model (Optional)
# ==============================
# LLM used for both General and Realtime chat. Default: llama-3.3-70b-versatile

GROQ_MODEL=llama-3.3-70b-versatile


# ==============================
# TAVILY API (Optional, Realtime mode)
# ==============================
# Required only for Realtime chat (web search). Get key at https://tavily.com
# If not set, Realtime mode still works but without live search results.

# TAVILY_API_KEY=your_tavily_api_key_here


# ==============================
# BRAIN MODEL (Optional, Jarvis mode)
# ==============================
# The brain classifies queries as "general" or "realtime" using Groq.
# Uses the same GROQ_API_KEYS with rotation (brain and chat never use the same key).
# Default: llama-3.1-8b-instant (fast classification).

# GROQ_BRAIN_MODEL=llama-3.1-8b-instant


# ==============================
# TEXT-TO-SPEECH (Optional)
# ==============================
# Server uses edge-tts (Microsoft Edge TTS). No API key needed.
# You can change the voice and speed via these two variables.

# Voice: default is en-GB-RyanNeural (male British, JARVIS-style).
# To list all voices, run in terminal:  edge-tts --list-voices
# Examples:
#   en-GB-RyanNeural          (British male, default)
#   en-US-ChristopherNeural   (US male)
#   en-US-JennyNeural         (US female)
#   en-IN-NeerjaNeural        (Indian English female)
#   hi-IN-MadhurNeural        (Hindi male)

TTS_VOICE=en-GB-RyanNeural

# Speed: percentage change from normal. Default +22% (slightly faster).
# Examples: +0% (normal), +10%, +22%, -10% (slower)

TTS_RATE=+22%


# ==============================
# Assistant & User Identity (Optional)
# ==============================
# How the AI introduces itself and how it addresses you.

# Assistant name shown in the UI and used in replies. Default: Jarvis
# ASSISTANT_NAME=Jarvis

# How the AI may address you (e.g. Sir, Shreshth). Leave empty to use
# names from learning data / conversation only.
# JARVIS_USER_TITLE=Sir

# Owner's name (e.g. Shreshth). Helps the AI know who it serves; prevents confusion
# when asked "who is Jarvis" (it knows it's Jarvis, not Elon Musk's AI).
# JARVIS_OWNER_NAME=Shreshth