.env.example

# Kawkab AI — Environment Configuration
# Copy this file to .env and fill in your values.
# Kawkab AI runs fully offline with no API keys required.
# Only fill in keys if you want external data providers.

# === Core Settings ===
KAWKAB_LANG=en              # Language: en or ar
KAWKAB_DEBUG=false           # Enable debug mode (verbose logging)
KAWKAB_DATA_DIR=             # Custom data directory (default: ~/Documents/KawkabAI/)

# === External Football Data APIs (optional) ===
# These are read-only public data providers for match/league info.
# Kawkab AI works 100% offline without any of these.

# Football-Data.org (https://www.football-data.org)
# Free tier: 10 requests/min, 1000/day
FOOTBALL_DATA_API_KEY=

# API-Football (https://www.api-football.com)
# Requires free registration
APIFOOTBALL_API_KEY=

# Bzzoiro (https://www.bzzoiro.com)
BZZOIRO_API_KEY=

# === LLM Provider (optional, for analysis reports) ===
# Local: Ollama (default, runs on RTX 4070)
LLM_PROVIDER=ollama
OLLAMA_URL=http://localhost:11434
OLLAMA_MODEL=qwen2.5:14b

# Remote: OpenAI-compatible (set API key if not using local Ollama)
OPENAI_API_KEY=
OPENAI_MODEL=gpt-4

# === Optional Service Flags ===
ENABLE_FACE_RECOGNITION=true     # Requires insightface + onnx<1.19
ENABLE_WEATHER_DETECTION=true    # Uses local CNN model
ENABLE_REALTIME_ANALYSIS=false   # Enable live video processing

# === Physics Engine (optional, for set-piece simulation) ===
FLUIDX3D_PATH=                   # Path to FluidX3D binary for physics sims
ENABLE_PHYSICS_SIM=false

# === Security ===
# Session timeout in minutes (0 = no timeout)
SESSION_TIMEOUT_MINUTES=0