env.example

# ================================================================
# C.O.R.A - Environment Configuration Example
# ================================================================
#
# HOW TO USE THIS FILE:
# 1. Copy this file and rename it to ".env" (with the dot)
# 2. Fill in your API keys following the instructions below
# 3. NEVER commit your .env file to git!
#
# ================================================================

# ============================================================
# POLLINATIONS.AI - FREE IMAGE GENERATION (RECOMMENDED)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Go to: https://enter.pollinations.ai/
# 2. Click "Get API Key" or sign up
# 3. Copy your API key (starts with "pk_")
# 4. Paste it below
#
# This enables: AI image generation in CORA
# Cost: FREE
#
POLLINATIONS_API_KEY=pk_your_pollinations_key_here

# ============================================================
# GITHUB - FOR GIT OPERATIONS (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR TOKEN:
# 1. Go to: https://github.com/settings/tokens
# 2. Click "Generate new token (classic)"
# 3. Give it a name like "CORA"
# 4. Select scopes: repo, user
# 5. Click "Generate token"
# 6. Copy the token (starts with "ghp_")
# 7. Paste it below
#
# This enables: Git push/pull, GitHub integration
# Cost: FREE
#
GITHUB_TOKEN=ghp_your_github_token_here

# ============================================================
# OPENWEATHERMAP - WEATHER DATA (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Go to: https://openweathermap.org/api
# 2. Click "Sign Up" and create account
# 3. Go to "API Keys" tab in your account
# 4. Copy your API key
# 5. Paste it below
#
# This enables: Weather updates and forecasts
# Cost: FREE (up to 1000 calls/day)
#
WEATHER_API_KEY=your_openweathermap_key_here

# ============================================================
# NEWS API - NEWS HEADLINES (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Go to: https://newsapi.org/
# 2. Click "Get API Key"
# 3. Sign up for free account
# 4. Copy your API key
# 5. Paste it below
#
# This enables: News headlines during boot
# Cost: FREE (100 requests/day)
#
NEWS_API_KEY=your_newsapi_key_here

# ============================================================
# ANTHROPIC - CLAUDE AI (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Go to: https://console.anthropic.com/
# 2. Sign up or log in
# 3. Go to "API Keys"
# 4. Click "Create Key"
# 5. Copy the key (starts with "sk-ant-")
# 6. Paste it below
#
# This enables: Claude AI as an alternative to Ollama
# Cost: Pay-per-use (see anthropic.com/pricing)
#
ANTHROPIC_API_KEY=sk-ant-your_anthropic_key_here

# ============================================================
# OPENAI - GPT MODELS (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Go to: https://platform.openai.com/
# 2. Sign up or log in
# 3. Go to "API Keys"
# 4. Click "Create new secret key"
# 5. Copy the key (starts with "sk-")
# 6. Paste it below
#
# This enables: GPT-4, GPT-3.5 as alternatives
# Cost: Pay-per-use (see openai.com/pricing)
#
OPENAI_API_KEY=sk-your_openai_key_here

# ============================================================
# ELEVENLABS - PREMIUM TTS VOICES (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Go to: https://elevenlabs.io/
# 2. Sign up for free account
# 3. Click your profile icon > Profile
# 4. Copy your API key
# 5. Paste it below
#
# This enables: High-quality AI voices
# Cost: FREE tier available (10k chars/month)
#
ELEVENLABS_API_KEY=your_elevenlabs_key_here

# ============================================================
# EMBY/JELLYFIN - MEDIA SERVER (OPTIONAL)
# ============================================================
#
# HOW TO GET YOUR API KEY:
# 1. Open your Emby/Jellyfin dashboard
# 2. Go to: Settings > API Keys
# 3. Create a new key for "CORA"
# 4. Copy the key and paste below
# 5. Also set your server URL
#
# This enables: Media playback control
#
EMBY_URL=http://localhost:8096
EMBY_API_KEY=your_emby_key_here

# ============================================================
# OLLAMA - LOCAL AI (NO KEY NEEDED)
# ============================================================
#
# Ollama runs locally - no API key required!
# Just install Ollama and pull models:
#   ollama pull llama3.2
#   ollama pull llava
#
# Change host only if running Ollama on different machine:
OLLAMA_HOST=http://localhost:11434

# ============================================================
# CORA SETTINGS
# ============================================================

# Default location for weather (city name)
DEFAULT_LOCATION=New York

# Wake word sensitivity (0.0 - 1.0)
WAKE_WORD_SENSITIVITY=0.5

# TTS Voice (Kokoro voices: af_bella, af_sarah, am_adam, etc.)
TTS_VOICE=af_bella

# TTS Speed (0.5 - 2.0)
TTS_SPEED=1.0

# AI Model for chat (Ollama model name)
AI_MODEL=llama3.2

# AI Temperature (0.0 = focused, 1.0 = creative)
AI_TEMPERATURE=0.7

# ============================================================
# WHAT WORKS WITHOUT API KEYS
# ============================================================
#
# CORA works great with NO API keys! These features are FREE:
# - Ollama AI chat (local, private, unlimited)
# - Ollama vision (llava model)
# - Kokoro TTS (neural voice, local)
# - Voice recognition (Vosk, local)
# - All cora_tools (code execution, file management, etc.)
# - YouTube playback (with mpv)
# - System monitoring
# - Task management
# - Knowledge base
#
# API keys just add extra features like:
# - AI image generation (Pollinations)
# - Weather data
# - News headlines
# - GitHub integration
#
# ============================================================