Nous Research open-source self-improving personal agent host Fact-checked · 2026-11-17

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

Pricing & quota
MIT open-source free · Pay your model provider or Nous Portal

Free to install and self-host; bring your own API keys (OpenRouter, Anthropic, OpenAI, DeepSeek), use Nous Portal subscription quota, or run local models.

Models & providers
Nous Portal, OpenRouter, Anthropic, OpenAI, DeepSeek & local models

Switch providers any time with the interactive `hermes model` selector or in `~/.hermes/config.yaml`.

OS & surfaces
Linux · macOS · Windows (WSL 2 required) + Chat gateways

Interactive terminal CLI plus `hermes gateway` for Telegram, Discord, Slack, WhatsApp and Feishu/Lark.

Safety & permissions
Defaults to `local` backend + `smart` approval · Switch to `docker` + `manual`

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.

Plugins, routing & companion extensions

Productivity & Collaboration

Hermes Web UI

A self-hosted browser and phone interface for operating your Hermes Agent.

68 · Some gaps ★ 20k · 1d ago
Productivity & Collaboration

Hermes One

A desktop companion that installs, configures, and operates Hermes Agent from one interface.

72 · Some gaps ★ 15k · 3d ago
Productivity & Collaboration

Hermes Studio

A self-hosted workspace for running Hermes Agent chats, workflows, channels, and local runtime operations.

78 · Good ★ 12k · 1d ago
Writing & Content

Hermes Agent: The Orange Book Guide

A bilingual, hands-on guide to Hermes Agent’s features, interfaces, and deployment boundaries.

32 · Major gaps ★ 5.1k · 1mo ago
Data & Analysis

Mnemosyne

Zero-cloud AI memory layer, SQLite-backed, single pure-Python dependency, works with any agent framework.

71 · Some gaps ★ 3.7k · 2d ago
Automation & Ops

ClawPanel

A cross-platform control panel for installing, configuring, diagnosing, and operating OpenClaw and Hermes Agent.

48 · Major gaps ★ 2.9k · 3d ago
Automation & Ops

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.

49 · Major gaps ★ 2.8k · 1mo ago
Productivity & Collaboration

Conduit

A native iOS and Android client for private models, Open WebUI, and self-hosted agents.

70 · Some gaps ★ 2.5k · today
Dev & Engineering

Hermes Agent CN Desktop

Community desktop client for Hermes Agent, Windows-first, built with Tauri, with a bundled core and one-click install.

55 · Major gaps ★ 1.9k · today
Automation & Ops

Hermes HUD Web UI

A browser-based consciousness monitor for your Hermes agent's health, memory, spend and run history.

60 · Some gaps ★ 1.9k · 2d ago
Automation & Ops

Hermes Control Interface

A self-hosted, password-gated web dashboard and operations control plane for the Hermes AI agent stack.

46 · Major gaps ★ 901 · 4mo ago
Automation & Ops

HermesClaw

Share one WeChat iLink account across Hermes, OpenClaw, and OpenCode.

52 · Major gaps ★ 765 · 1mo ago
Productivity & Collaboration

HermesOffice

A free, open-source AI office suite that edits real Office files locally — Word, Excel, PowerPoint, PDF and Markdown.

75 · Good ★ 633 · 12d ago
Dev & Engineering

Scope Recall

Give supported coding assistants shared, local long-term memory with traceable sources and owner controls.

82 · Good ★ 542 · 8d ago
Automation & Ops

Hermes Agent Railway Console

Deploy, configure, supervise, and back up a self-hosted Hermes Agent from one web console.

68 · Some gaps ★ 328 · 1mo ago
Productivity & Collaboration

Portable Hermes Agent

A portable Windows desktop for connecting AI models, generation tools, and workflow automation in one place.

53 · Major gaps ★ 251 · 2d ago
Productivity & Collaboration

YantrikDB Memory for Hermes

Give Hermes Agent persistent, maintainable memory with traceable recall, duplicate cleanup, and contradiction handling.

72 · Some gaps ★ 97 · 16d ago
Dev & Engineering

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.

Insufficient evidence ★ 18 · 3mo ago

Browse Hermes Agent skills on FollowSkills →

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`.

Host agent ecosystem hubs