FAQ & Troubleshooting
Quick answers and fixes for the most common questions and issues. Frequently Asked Questions What LLM providers work with Hermes? Hermes Agent works with any Op
Quick answers and fixes for the most common questions and issues. Hermes Agent works with any OpenAI-compatible API. Supported providers include: Set your provider with or by editing . See the Environment Variables reference for all provider keys. The installer provisions a PortableGit that backs the terminal tool's shell. …
What this page covers
- Frequently Asked Questions
- What LLM providers work with Hermes?
- Does it work on Windows?
- I run Hermes in WSL2. What's the best way to control my normal Windows Chrome?
- Does it work on Android / Termux?
- Is my data sent anywhere?
- Can I use it offline / with local models?
- How much does it cost?
- Can multiple people use one instance?
- What's the difference between memory and skills?
- Can I use it in my own Python project?
- Troubleshooting
- Installation Issues
- Provider & Model Issues
- Terminal Issues
- Messaging Issues
- Performance Issues
- MCP Issues
- Profiles
- How do profiles differ from just setting HERMESHOME?
- Can two profiles share the same bot token?
- Do profiles share memory or sessions?
- What happens when I run hermes update?
- How many profiles can I run?
- Workflows & Patterns
- Using different models for different tasks (multi-model workflows)
- Running multiple agents on one WhatsApp number (per-chat binding)
- Controlling what shows up in Telegram (hiding logs and reasoning)
- Managing skills on Telegram (slash command limit)
- Shared thread sessions (multiple users, one conversation)
- Exporting Hermes to another machine
- Moving a single profile to another machine
- hermes backup vs hermes profile export
- Permission denied when reloading shell after install
- Error 400 on first agent run
- Still Stuck?
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Reference
CLI Commands Reference
This page covers the terminal commands you run from your shell. For in chat slash commands, see Slash Commands Reference. Global entrypoint Global options Optio
Slash Commands Reference
Hermes has two slash command surfaces, both driven by a central in : Interactive CLI slash commands — dispatched by , with autocomplete from the registry Messag
Profile Commands Reference
Profile Commands Reference This page covers all commands related to Hermes profiles. For general CLI commands, see CLI Commands Reference. Top level command for
Environment Variables
Environment Variables Reference All variables go in . You can also set them with . LLM Providers Variable Description OpenRouter API key (recommended for flexib
Built-in Tools Reference
This page documents Hermes' built in tools, grouped by toolset. Availability varies by platform, credentials, and enabled toolsets. Quick counts (current regist
Toolsets Reference
Toolsets are named bundles of tools that control what the agent can do. They're the primary mechanism for configuring tool availability per platform, per sessio