FAQ

Not supported. Use WSL2 (Ubuntu 22.04 LTS recommended), or on phone/tablet use Termux. Our tutorials focus on WSL2 and Termux for Windows users.

Some terminal input methods conflict with the interactive wizard. Press Ctrl+C to exit, manually edit ~/.hermes/config.yaml for a minimal config, then add API keys on Day 2.

Possibly. Set Termux to unrestricted battery mode, and before starting the gateway run termux-wake-lock.

Hermes supports many providers: Anthropic Claude, Google Gemini, OpenRouter, DeepSeek, local Ollama, HuggingFace, and more. Run hermes model to pick one and paste your key — or edit ~/.hermes/.env directly.

Usually key format mismatch or missing base_url. Run hermes model to review configured providers; manually fill base_url in ~/.hermes/config.yaml if needed.

Rate-limited. Swap provider or set fallback_model in config.yaml.

Check the webhook URL points to your new Hermes endpoint, and that the BotFather token is still valid. If you poll, make sure only one gateway process holds the token. hermes status shows connection health.

In Feishu's Event Subscriptions, confirm the Message event is enabled and the webhook URL is HTTPS-reachable from the open internet.

Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, Home Assistant, Mattermost, DingTalk, WeCom, BlueBubbles, SMS, and more.

tar -czf ~/hermes-backup.tar.gz -C ~ .hermes/ — captures config, skills, and memory.

hermes doctor for full health check, hermes status for the active-config summary.

1) pip install --upgrade hermes-agent. 2) hermes version to confirm. 3) If config format changed, hermes setup will auto-migrate it.

pip install --upgrade hermes-agent. Then hermes version to verify.