Download and Install Hermes Agent on macOS

Fastest install on macOS: download the official Desktop installer, or run the official one-line install command in Terminal.

Who this is for：First-time users installing Hermes Agent on a Mac. No need to pre-install Python or Node.js.

Steps

Option 1: Official Desktop installer (recommended)

Download the Hermes Desktop installer from the official site and run it. It automatically handles Python 3.11, Node.js v22, ripgrep, and ffmpeg.
Option 2: One-line terminal install

Open Terminal and run the official install command.
```
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
Prerequisite check

Git is the only prerequisite. Verify with the command below; macOS will offer Xcode Command Line Tools if missing.
```
git --version
```
Reload your shell and start

After the install finishes, reload your shell config and run hermes.
```
source ~/.zshrc
hermes
```
Configure a model provider

On first start, choose an LLM provider and set an API key.
```
hermes model
```

Your shell has not reloaded PATH. Run source ~/.zshrc (zsh) or source ~/.bashrc (bash), or open a new terminal.

No. The official installer handles Python 3.11, Node.js v22, ripgrep, and ffmpeg.

Per-user default is ~/.hermes/hermes-agent/.