60 seconds to install

Install Hermes Agent

One-line script. Works on Linux, macOS, WSL2, and Android Termux. Start chatting the moment it finishes.

terminal

Hermes is a Python project. Run python3 --version to check.

wifi

The install script downloads from GitHub. Use a proxy if needed.

computer

Linux, macOS, WSL2. Windows native is not supported — use WSL2 instead.

Open a terminal and run the official install script. It detects your environment and installs the Hermes runtime with all dependencies.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

macOS ships with curl. If you hit permission errors, run xcode-select --install first.

✓ Hermes installed successfully

Run `hermes` to start chatting

First-run configuration walks you through model provider and API key setup.

hermes setup

Good to go. Run hermes to open the interactive CLI and start your first conversation.

hermes

Start the 7-day path: zero to shipped automation.

Start Day 1

Install script failed — what now?expand_more

Check that you can reach GitHub. If not, install directly with pip install hermes-agent. Python must be ≥ 3.10.

How do I uninstall?expand_more

Run hermes uninstall. Config lives in ~/.hermes/ — delete it manually if you want a clean slate.

Which OS are supported?expand_more

Linux, macOS, Windows WSL2, Android Termux. Windows native is not supported.