hermes / .env.example
Farhan Beg
feat(sync): warn when keys live in ephemeral .env on a Space
b047e12
# ── Required ──────────────────────────────────────────────────────────
GATEWAY_TOKEN=change-me-to-a-strong-random-string
LLM_API_KEY=your-llm-provider-api-key
LLM_MODEL=openrouter/anthropic/claude-sonnet-4
# Examples for other providers:
# LLM_MODEL=openai/gpt-4o
# LLM_MODEL=anthropic/claude-sonnet-4-6
# LLM_MODEL=google/gemini-2.5-flash
# LLM_MODEL=deepseek/deepseek-chat
# LLM_MODEL=huggingface/Qwen/Qwen3-235B-A22B-Thinking-2507
# ── HF Dataset persistence (recommended) ──────────────────────────────
# Write-scope token: https://huggingface.co/settings/tokens
# HF_TOKEN=hf_xxx
# BACKUP_DATASET_NAME=huggingmes-backup
# Backup is change-driven: every push happens after the watched dirs have been
# quiet for SYNC_DEBOUNCE_SECONDS, capped at SYNC_INTERVAL even under constant
# writes. Drop these only if you understand the trade-off; lower = more pushes.
# SYNC_POLL_INTERVAL=2
# SYNC_DEBOUNCE_SECONDS=3
# SYNC_INTERVAL=60
# Back up $HERMES_HOME/.env (provider keys typed via the dashboard's Env tab)
# into the private dataset. OFF by default β€” see README "Configure LLM
# Provider via Config Editor" for the security tradeoff. Prefer adding keys
# as HF Space Secrets, which never touch disk.
# SYNC_INCLUDE_ENV=1
# ── Optional: Cloudflare proxy + keep-alive ───────────────────────────
# CLOUDFLARE_WORKERS_TOKEN=cf_xxx
# CLOUDFLARE_ACCOUNT_ID=
# CLOUDFLARE_KEEPALIVE_CRON=*/10 * * * *
# ── Optional: Telegram bridge ─────────────────────────────────────────
# TELEGRAM_BOT_TOKEN=123456:ABC
# TELEGRAM_ALLOWED_USERS=11111111,22222222
# TELEGRAM_MODE=webhook
# ── Optional: swap the landing page to the HuggingMes status page ─────
# PRIMARY_UI=dashboard
# ── Optional: custom OpenAI-compatible endpoint ───────────────────────
# CUSTOM_BASE_URL=http://localhost:11434/v1
# CUSTOM_MODEL_CONTEXT_LENGTH=131072
# CUSTOM_MODEL_MAX_TOKENS=8192
# ── Reproducibility: pin the Hermes Agent base image ──────────────────
# HERMES_AGENT_VERSION=latest