Hermes Agent Hub: Setup, Nous Portal, Chat Gateways, Safety and Skills
Guide to Nous Research's MIT-licensed Hermes Agent: connecting models via Nous Portal or your own keys, tightening `smart` approval and `local` execution defaults, and connecting Telegram or Discord safely.
Key takeaways
- Hermes Agent (`NousResearch/hermes-agent`) is an MIT-licensed persistent agent featuring cross-session memory, self-authored `SKILL.md` skills and multi-channel messaging gateways.
- Connects to Nous Portal OAuth, OpenRouter, Anthropic, OpenAI, DeepSeek or local Ollama models via `hermes model`.
- Safety highlight: defaults to `terminal.backend: local` and `approvals.mode: smart`. Set user allowlists and switch to `docker` or `modal` backends before enabling chat gateways.
- Follows the open `SKILL.md` specification and supports MCP servers.
Key facts: pricing, models, surfaces & safety
Free to install and self-host; bring your own API keys (OpenRouter, Anthropic, OpenAI, DeepSeek), use Nous Portal subscription quota, or run local models.
Switch providers any time with the interactive `hermes model` selector or in `~/.hermes/config.yaml`.
Interactive terminal CLI plus `hermes gateway` for Telegram, Discord, Slack, WhatsApp and Feishu/Lark.
Set `approvals.mode: manual`, isolate execution with `terminal.backend: docker`, and restrict `*_ALLOWED_USERS` before running messaging gateways.
Extension points: ~/.hermes/config.yaml, SKILL.md and Gateways
Hermes Agent stores all state and extensions under `~/.hermes/`:
~/.hermes/config.yaml & .env
Controls model selection, `approvals.mode`, `terminal.backend` (local/docker/modal/ssh) and gateway user allowlists.
Skills Hub & Self-Improving SKILL.md
Uses standard `SKILL.md` folders that Hermes can both install from registries and synthesize after solving tasks.
MCP Server integration
Connects external Model Context Protocol tool servers in `config.yaml`.
Setup & troubleshooting guides
Hermes Agent ecosystem & extensions
Plugins, config packs, switchers and orchestration layers in the directory built for Hermes Agent, by stars; each has its own FARS review.
Multi-agent orchestration, parallel sessions & workbenches
Cross-session memory & context tools
Plugins, routing & companion extensions
Hermes Web UI
A self-hosted browser and phone interface for operating your Hermes Agent.
Hermes One
A desktop companion that installs, configures, and operates Hermes Agent from one interface.
Hermes Studio
A self-hosted workspace for running Hermes Agent chats, workflows, channels, and local runtime operations.
Hermes Agent: The Orange Book Guide
A bilingual, hands-on guide to Hermes Agent’s features, interfaces, and deployment boundaries.
Mnemosyne
Zero-cloud AI memory layer, SQLite-backed, single pure-Python dependency, works with any agent framework.
ClawPanel
A cross-platform control panel for installing, configuring, diagnosing, and operating OpenClaw and Hermes Agent.
SkillClaw: Collective Skill Evolution Framework
Let AI agents evolve skills from real interactions—across sessions, agents, devices, and users. Install and forget; evolution happens in the background.
Conduit
A native iOS and Android client for private models, Open WebUI, and self-hosted agents.
Hermes Agent CN Desktop
Community desktop client for Hermes Agent, Windows-first, built with Tauri, with a bundled core and one-click install.
Hermes HUD Web UI
A browser-based consciousness monitor for your Hermes agent's health, memory, spend and run history.
Hermes Control Interface
A self-hosted, password-gated web dashboard and operations control plane for the Hermes AI agent stack.
HermesClaw
Share one WeChat iLink account across Hermes, OpenClaw, and OpenCode.
HermesOffice
A free, open-source AI office suite that edits real Office files locally — Word, Excel, PowerPoint, PDF and Markdown.
Scope Recall
Give supported coding assistants shared, local long-term memory with traceable sources and owner controls.
Hermes Agent Railway Console
Deploy, configure, supervise, and back up a self-hosted Hermes Agent from one web console.
Portable Hermes Agent
A portable Windows desktop for connecting AI models, generation tools, and workflow automation in one place.
YantrikDB Memory for Hermes
Give Hermes Agent persistent, maintainable memory with traceable recall, duplicate cleanup, and contradiction handling.
Xiaoma AI Hermes Chinese Enhancement Pack
A one-command Chinese localization patch for Hermes Desktop, TUI and CLI, auto-matched to your Hermes version so Chinese users can read every screen.
Hermes Agent comparisons & rankings
Related concepts
Frequently asked questions
Does Hermes Agent run natively on Windows?
No. On Windows you must install and run Hermes Agent inside WSL 2 rather than native PowerShell or CMD.
How do I secure Hermes Agent when connecting Telegram or Discord?
Never set `GATEWAY_ALLOW_ALL_USERS=true`. Specify your own user ID in `TELEGRAM_ALLOWED_USERS` (or the matching platform variable) inside `~/.hermes/.env` and set `terminal.backend: docker`.