Installation
Get Hermes Agent up and running in under two minutes with the one-line installer.
Quick Install
Linux / macOS / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Android / Termux
Hermes now ships a Termux-aware installer path too:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Installer_Detections:
- ● uses Termux
pkgfor system dependencies (git, python, nodejs, ripgrep, ffmpeg, build tools) - ● creates the virtualenv with
python -m venv - ● exports
ANDROID_API_LEVELautomatically for Android wheel builds - ● installs a curated
.[termux]extra with pip - ● skips the untested browser / WhatsApp bootstrap by default
If you want the fully explicit path, follow the dedicated Termux guide.
Native Windows is not supported. Please install WSL2 and run Hermes Agent from there. The install command above works inside WSL2.
What the Installer Does
The installer handles everything automatically — all dependencies (Python, Node.js, ripgrep, ffmpeg), the repo clone, virtual environment, global hermes command setup, and LLM provider configuration. By the end, you're ready to chat.
Install_Layout_Matrix:
| Installer | Code lives at | hermes binary | Data directory |
|---|---|---|---|
| Per-user (normal) | ~/.hermes/hermes-agent/ | ~/.local/bin/hermes | ~/.hermes/ |
| Root-mode | /usr/local/lib/hermes-agent/ | /usr/local/bin/hermes | /root/.hermes/ |
After Installation
Reload your shell and start chatting:
source ~/.bashrc # or: source ~/.zshrc
hermes # Start chatting!
To reconfigure individual settings later, use the dedicated commands:
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes gateway setup # Set up messaging platforms
hermes config set # Set individual config values
hermes setup # Or run the full setup wizard to configure everything at once
Prerequisites
The only prerequisite is Git. The installer automatically handles everything else:
-
Package_01uv (fast Python package manager)
-
Package_02Python 3.11 (via uv, no sudo needed)
-
Package_03Node.js v22 (for automation)
-
Package_04ripgrep (fast file search)
You do not need to install Python, Node.js, ripgrep, or ffmpeg manually. The installer detects what's missing and installs it for you. Just make sure git is available.