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
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 when something breaks. Pick the row that matches your goal: To easily install the command-line and desktop applications, download the Hermes Desktop installer from our website and run it. …
What this page covers
- Prefer to watch?
- Who this is for
- The fastest path
- 1. Install Hermes Agent
- With the Hermes Desktop installer on macOS or Windows (recommended)
- Without Hermes Desktop:
- 2. Choose a Provider
- How settings are stored
- 3. Run Your First Chat
- 4. Verify Sessions Work
- 5. Try Key Features
- Use the terminal
- Slash commands
- Multi-line input
- Interrupt the agent
- 6. Add the Next Layer
- Bot or shared assistant
- Automation and tools
- Sandboxed terminal
- Voice mode
- Skills
- MCP servers
- Editor integration (ACP)
- Common Failure Modes
- Recovery Toolkit
- Quick Reference
- Next Steps
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
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
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 —