.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

# Telegram mode: "webhook" (default, requires Cloudflare proxy) or "polling"
# TELEGRAM_MODE=webhook

# Telegram webhook URL (auto-set via Cloudflare Worker; override only if manual)
# TELEGRAM_WEBHOOK_URL=https://your-webhook.workers.dev

# ── 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

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

# ── OPTIONAL: Startup Scripts & Package Install ──
# Run arbitrary bash on every boot (before Hermes gateway launches).
# Supports base64: prefix for quote-heavy scripts.
# HUGGINGMES_RUN="""
# sudo apt-get install -y ffmpeg
# pip install pandas
# """

# Install packages from day one (before terminal is opened)
# HUGGINGMES_APT_PACKAGES=ffmpeg,git-lfs
# HUGGINGMES_PIP_PACKAGES=pandas,requests
# HUGGINGMES_NPM_PACKAGES=typescript

# ── OPTIONAL: Gateway Restart Behavior ──
# Seconds to wait between gateway restarts (default: 5)
# GATEWAY_RESTART_DELAY=5

# Max gateway restarts before container exits (default: unlimited)
# GATEWAY_MAX_RESTARTS=10

# ── OPTIONAL: API Key Rotation ──
# Comma-separated key pools per provider for round-robin rotation.
# The first key in a pool is also promoted to the singular env var.
# ANTHROPIC_API_KEYS=sk-ant-key1,sk-ant-key2,sk-ant-key3
# OPENAI_API_KEYS=sk-openai-key1,sk-openai-key2
# GEMINI_API_KEYS=AIza-key1,AIza-key2
# DEEPSEEK_API_KEYS=key1,key2
# GROQ_API_KEYS=gsk_key1,gsk_key2
# MISTRAL_API_KEYS=key1,key2
# OPENROUTER_API_KEYS=sk-or-key1,sk-or-key2
# XAI_API_KEYS=key1,key2
# NVIDIA_API_KEYS=key1,key2
# COHERE_API_KEYS=key1,key2
# TOGETHER_API_KEYS=key1,key2
# CEREBRAS_API_KEYS=key1,key2

# ── OPTIONAL: Terminal (JupyterLab) ──
# Terminal is ON by default when GATEWAY_TOKEN is set.
# Set DEV_MODE=false to disable it entirely.
# DEV_MODE=false

# Override terminal password (optional — defaults to GATEWAY_TOKEN)
# JUPYTER_TOKEN=your_separate_terminal_token_here

# ── OPTIONAL: Advanced ──
# Webhook URL for restart/backup-failure notifications
# WEBHOOK_URL=https://your-webhook-endpoint.com/notify