.env.example

# ============================================================================
# HuggingMes - Hermes Agent on Hugging Face Spaces
# Configuration Reference
# ============================================================================

# ── REQUIRED: Core Configuration ──
# Your LLM provider API key
LLM_API_KEY=your_api_key_here

# LLM model to use (e.g. google/gemini-2.0-flash, openai/gpt-4o)
LLM_MODEL=google/gemini-2.0-flash

# Bearer token for the proxied Hermes API routes and Dashboard
# Generate: openssl rand -hex 32
GATEWAY_TOKEN=your_gateway_token_here

# ── OPTIONAL: Chat Integrations ──
# Get bot token from: https://t.me/BotFather
# TELEGRAM_BOT_TOKEN=your_bot_token_here

# Allowed Telegram User IDs (comma-separated numeric IDs)
# TELEGRAM_ALLOWED_USERS=123456789,987654321

# ── OPTIONAL: Cloudflare Proxy & Keep-Alive ──
# Cloudflare API token for automatic Worker proxy and KeepAlive setup
# CLOUDFLARE_WORKERS_TOKEN=your_cloudflare_token_here

# Alternatively, manual proxy config:
# CLOUDFLARE_PROXY_URL=https://your-proxy.workers.dev
# CLOUDFLARE_PROXY_SECRET=your_proxy_secret_here

# Extra domains to proxy, comma-separated. Set to "*" to proxy all.
# CLOUDFLARE_PROXY_DOMAINS=api.sendgrid.com,slack.com

# ── OPTIONAL: Workspace Backup to HF Dataset ──
# HF token with write access for private Dataset backup
HF_TOKEN=hf_your_token_here

# Dataset name (default: huggingmes-backup)
# BACKUP_DATASET_NAME=huggingmes-backup

# Backup interval in seconds (default: 180)
SYNC_INTERVAL=180

# ── OPTIONAL: Advanced ──
# Telegram mode (webhook/polling)
TELEGRAM_MODE=webhook

# Include .env in backups (default: false)
# SYNC_INCLUDE_ENV=false