How-To Series · Episode 05 / 59 · Module 1: Get Running

Hermes · The Nix Way

Three levels of integration. Pick the one that fits.

After this videoYou can now install and run Hermes via Nix · CLI, native service, or container.

Hermes ships a single Nix flake with three integration levels. Level 1 is nix run or nix profile install — any Mac/Linux box with Nix. Level 2 is the NixOS module in native mode, a hardened systemd service generated from configuration.nix. Level 3 is the same module with container.enable = true, which runs Hermes inside a persistent Ubuntu container so the agent can apt, pip, and npm install things that survive restarts. Managed mode blocks hermes setup, hermes config edit, and hermes gateway install — Nix is the source of truth.

About these resources. The Nix doc is the only source of facts in this video — three integration levels, the module options, managed-mode CLI blocks, container mode, and secrets handling all come from there. The Standard Installation doc is referenced only as the workflow the post-install CLI matches.

Sources · What this video distills

2 docs pages · every command below traces to one of them
Primary · the flake, the NixOS module, managed mode, container architecture
Nix & NixOS Setup
Read ↗
The post-install CLI workflow (hermes setup, hermes chat) reused after nix profile install
Standard Installation
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Level 1 · One-shot runfrom Nix & NixOS Setup ↗
nix run github:NousResearch/hermes-agent -- setup
Level 1 · Persistent installfrom Nix & NixOS Setup ↗
nix profile install github:NousResearch/hermes-agent
Levels 2 + 3 · Apply NixOS configfrom Nix & NixOS Setup ↗
sudo nixos-rebuild switch
Watch the gateway servicefrom Nix & NixOS Setup ↗
journalctl -u hermes-agent -f

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Next in the series · Episodes that build on this

E02
One-Line Install
E06
Updating Hermes Safely
E24
Hermes on Telegram