An autonomous agent that runs on your server, remembers what it learns, and grows over time — install, CLI, and gateway essentials on one page.
Maintaining this reference takes time — thanks if you can chip in.
☕ Buy me a coffee · other ways to support
uv, Python 3.11, clones the repo, no sudo.hermes setup — interactive wizard · hermes model — pick Nous Portal (OAuth), OpenRouter (API key), or your own endpoint.hermes — full interactive CLI with tools, memory, and skills.hermes gateway setup → hermes gateway → hermes gateway install (Telegram, Discord, Slack, WhatsApp; systemd service on Linux).hermes update — pull latest changes and reinstall dependencies.From the product site: it is not a coding copilot chained to an IDE or a thin wrapper around one API. It is an autonomous agent that lives on your machine or server, persists memory, generates skills from experience, and improves the longer it runs — with a real CLI, optional messaging gateway, sandboxed execution, and multi-model tooling.
Official installer targets Linux, macOS, and WSL2. Native Windows is called out as experimental — use WSL2 for a supported path. Source: hermes-agent.nousresearch.com.
One-line install from the main branch script: installs tooling (including uv), Python 3.11, clones the project, and sets up the environment — typically without sudo.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup for the interactive wizard.hermes to start the interactive CLI.hermes update anytime to sync upstream and refresh dependencies.| Source | Notes |
|---|---|
| Nous Portal | OAuth sign-in through the Nous portal. |
| OpenRouter | Bring your OpenRouter API key. |
| Your endpoint | Any OpenAI-compatible HTTP API you operate. |
Commands: hermes setup (wizard) · hermes model (choose / change model configuration).
Account and billing flows are hosted on the Nous portal — use the Sign Up on Nous Portal call-to-action on the official landing page.
hermes # Interactive session (tools, memory, skills) hermes setup # Configuration wizard hermes model # Model / provider selection hermes update # Pull latest + reinstall deps
For subcommands and flags beyond this summary, use upstream Features and Docs on hermes-agent.nousresearch.com and the GitHub repository.
Connect Telegram, Discord, Slack, or WhatsApp through a single gateway process. The site documents an interactive gateway wizard and optional install as a system service (for example systemd on Linux).
hermes gateway setup # Interactive gateway wizard hermes gateway # Run the gateway hermes gateway install # Install as a system service
Start on CLI, then pick up the same agent on chat apps — scheduled automations and channel delivery run through this gateway layer per the official docs.
Telegram, Discord, Slack, WhatsApp, and CLI from one gateway — switch surfaces without rebuilding the agent.
Persistent memory plus auto-generated skills — learns your projects and retains how problems were solved.
Natural-language cron for reports, backups, and briefings unattended via the gateway.
Isolated subagents: separate conversations, terminals, Python RPC — lower context cost for pipelines.
Backends include local, Docker, SSH, Singularity, and Modal — hardened containers and namespace isolation.
Search, browser automation, vision, image generation, TTS, and multi-model reasoning in one stack.
Marketing copy on the site lists 40+ built-in tools spanning search, terminal, filesystem, browser automation, vision, image generation, TTS, code execution, subagent delegation, memory, planning, cron, multi-model routing, and more. Treat this cheatsheet as a map — exact tool names live in repo docs.
| Area | Examples (from site) |
|---|---|
| Web & browser | Search, browsing, snapshots, automation |
| Execution | Terminal, sandboxes, Python RPC / code run |
| Memory & plans | Long-term recall, task planning |
| Omni-channel | Gateway integrations, schedules |
| Media | Vision, image gen, TTS |
Telegram · Discord · Slack · WhatsApp · Signal · Email · CLI — all through the same Hermes gateway architecture described on hermes-agent.nousresearch.com.
The site highlights local installs plus remote / isolation options such as Docker, SSH, Modal, Daytona, and Singularity, with hardened containers (read-only root, dropped capabilities, namespaces). Match this list to your org’s safety requirements.
Hermes ships many bundled skills (site copy cites 40+ across MLOps, GitHub flows, research, and more). Agents can author new skills dynamically. The interchange format aligns with openagentskills.io, with community installs from ClawHub, LobeHub, and GitHub — as listed on the landing page.
Start from bundled skills, fork for your stack, and publish extras so every Hermes instance you run shares the same muscle memory.
Nous positions research-oriented flows: batch trajectory generation with parallel workers and checkpointing, Atropos integration for RL training, and exports to ShareGPT-style formats for fine-tuning with trajectory compression — see the Research blurb on the official site for the latest scope.
| Resource | URL |
|---|---|
| Product / install | hermes-agent.nousresearch.com |
| Source | github.com/NousResearch/hermes-agent |
| Nous Research | nousresearch.com |
This cheatsheet is independent documentation — always verify behavior against upstream docs and release notes.