Skip to content
SSyntalith
PLEN
Book a scan
← Back to blog
GuideHermes Agent: installation

Hermes Agent: Step-by-Step Installation (2026)

Hermes Agent is an open-source (MIT), self-hosted AI agent by Nous Research. You install it with a single command on Linux, macOS, WSL2, or Windows, connect your own model (Nous Portal, OpenAI, Anthropic, or local), and run it on a server for about 5 USD per month. It needs a model with a context window of at least 64,000 tokens.

SyntalithPublished June 29, 2026Updated June 29, 20267 min read

Hermes Agent is one of the easier open-source AI agents to install: a single command brings up a working environment. The harder and more important part is what happens next, namely what boundaries the agent has, what it can access, and who oversees it. This guide shows the installation step by step and what to watch for before you connect the agent to company systems.

Quick answer

Hermes Agent is an open-source (MIT), self-hosted AI agent by Nous Research. Installation comes down to a single command on Linux, macOS, WSL2, or Android (Termux):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

On Windows you run the PowerShell equivalent or the Hermes Desktop installer. Then hermes setup --portal connects a model and the basic tools. The agent runs on Linux, macOS, WSL2, Windows, and Android, and you can run it on a server for about 5 USD per month. It needs a model with a context window of at least 64,000 tokens.

Hermes Agent is a Nous Research tool. At Syntalith we use and operate it; it is not our own runtime.

What you need before installing

  • Git is the only prerequisite on Linux and macOS; the installer fetches the rest (uv, Python 3.11, Node.js, ripgrep, ffmpeg).
  • A language model with a context window of at least 64,000 tokens. You can use Nous Portal, OpenRouter, OpenAI, Anthropic, or your own local model. Hermes does not lock you to one provider: you switch models with hermes model.
  • A machine: a laptop for testing or a server for continuous use. The agent itself is lightweight; the main cost is the model. We cover that separately in how much Hermes Agent costs.

Installation step by step

  1. Install with one command (Linux/macOS/WSL2/Termux):
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

On Windows, run iex (irm https://hermes-agent.nousresearch.com/install.ps1) in PowerShell, or use the Hermes Desktop installer.

  1. Connect a model and tools: hermes setup --portal sets up a model plus the basic tools (web search, image generation, TTS, browser) with one login. If you prefer your own keys, go through the full setup.
  2. Verify it works: start a conversation in the terminal interface. hermes doctor shows what is configured and what may be missing.
  3. Optionally connect messengers: hermes gateway setup lets you talk to the agent from Telegram, Discord, Slack, or WhatsApp. Bring this layer up only once the CLI is stable.

Security and boundaries, the most important step

Installing is easy; running it safely in a company is the real work. Hermes has mechanisms for this, but you decide how to set them:

  • Command approval before risky actions are executed,
  • Container isolation and running as an unprivileged user,
  • DM pairing and allowlists for who can issue commands,
  • MCP: when connecting MCP servers, filter the tools and grant the least privilege needed.

The principle is the same one we apply to every agent: the agent gets a specific action, a specific system, a specific data scope, a log, and an owner. Why that matters is explained in our piece on prompt injection in AI agents.

Yourself or with a builder

One person can stand up Hermes for testing in minutes. Running it in a company with boundaries, isolation, logs, escalation, and maintenance is a project. If you want to move from demo to production without building the whole competence from scratch, we install and operate Hermes Agent remotely or on-site in Warsaw, in an isolated environment and with a human in the loop for irreversible actions.

The cheapest first step is a free process scan: in 30 minutes with an engineer we will establish whether Hermes is the right tool for your process or whether something simpler is enough.

Book a free process scan | How much Hermes Agent costs | Hermes Agent vs OpenClaw

Sources