Nix & NixOS Setup
Hermes Agent ships a Nix flake with three levels of integration: Level Who it's for What you get / Any Nix user (macOS, Linux) Pre built binary with all deps —
Hermes Agent ships a Nix flake with three levels of integration: No clone needed. Nix fetches, builds, and runs everything: After , , , and are on your PATH. From here, the workflow is identical to the standard installation — walks you through provider selection, sets up a launchd (macOS) or systemd user service, and config lives in . …
What this page covers
- Prerequisites
- Quick Start (Any Nix User)
- NixOS Module
- Add the Flake Input
- Minimal Configuration
- Container-aware CLI
- Verify It Works
- Choosing a Deployment Mode
- Configuration
- Declarative Settings
- Escape Hatch: Bring Your Own Config
- Customization Cheatsheet
- Secrets Management
- sops-nix
- agenix
- OAuth / Auth Seeding
- Documents
- MCP Servers
- Stdio Transport (Local Servers)
- HTTP Transport (Remote Servers)
- HTTP Transport with OAuth
- Sampling (Server-Initiated LLM Requests)
- Managed Mode
- Container Architecture
- What Persists Across What
- GC Root Protection
- Plugins
- Directory Plugins (extraPlugins)
- Entry-Point Plugins (extraPythonPackages)
- Optional Dependency Groups (extraDependencyGroups)
- Combining Both
- Using the Overlay
- Plugin Configuration
- Development
- Dev Shell
- direnv (Recommended)
- Flake Checks
- Options Reference
- Core
- Configuration
- Secrets & Environment
- Documents
- MCP Servers
- Service Behavior
- Container
- Directory Layout
- Native Mode
- Container Mode
- Updating
- Troubleshooting
- Service Logs
- Container Inspection
- Force Container Recreation
- Verify Secrets Are Loaded
- GC Root Verification
- Common Issues
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Getting Started
Installation
Get Hermes Agent up and running in under two minutes! Quick Install With the Hermes Desktop installer on macOS or Windows (recommended) To easily install the co
Quickstart
This guide gets you from zero to a working Hermes setup that survives real use. Install, choose a provider, verify a working chat, and know exactly what to do w
Learning Path
Hermes Agent can do a lot — CLI assistant, Telegram/Discord bot, task automation, RL training, and more. This page helps you figure out where to start and what
Updating & Uninstalling
Updating Git installs Update to the latest version with a single command: This pulls the latest code from , updates dependencies, and prompts you to configure a
Android / Termux
Hermes on Android with Termux This is the tested path for running Hermes Agent directly on an Android phone through Termux. It gives you a working local CLI on