Install on Linux

System Requirements

Requirement	Minimum	Recommended
OS	Any modern Linux	Ubuntu 22.04+ / Debian 12+
Python	3.10	3.11+
RAM	2GB	4GB+
Disk	1GB	5GB+
Network	Required	Broadband

Method 1: One-Line Install (Recommended)

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

This script automatically:

• Installs uv package manager
• Installs Python 3.11 (if not present)
• Clones the repository
• Sets up virtual environment
• Configures PATH

China Mirror

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

Method 2: Manual Install

Step 1: Install Dependencies

Ubuntu / Debian:

sudo apt update && sudo apt install -y python3 python3-pip python3-venv git curl

CentOS / RHEL:

sudo yum install -y python3 python3-pip git curl

Arch Linux:

sudo pacman -S python python-pip git curl

Step 2: Clone Repository

git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes-agent
cd ~/.hermes-agent

Step 3: Set Up Virtual Environment

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Step 4: Add to PATH

echo 'alias hermes="~/.hermes-agent/.venv/bin/python -m hermes"' >> ~/.bashrc
source ~/.bashrc

Step 3: Verify

hermes --version
hermes doctor

Troubleshooting

Python version too old

# Install Python 3.11 via deadsnakes PPA (Ubuntu)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3.11 python3.11-venv

Permission denied

# Don't use sudo with Hermes Agent
# If you get permission errors, fix ownership:
sudo chown -R $USER:$USER ~/.hermes

Network timeout

# Use China mirror for faster downloads
export HERMES_MIRROR=cn
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

Next Steps

• Model Configuration — Set up your LLM
• Quick Start — Start using Hermes Agent