Installing Hermes Agent

How to Install Hermes Agent

Hermes Agent is a powerful AI assistant with tool-calling capabilities. This guide walks you through the installation process on Linux/macOS.

Prerequisites

• Python 3.10+
• Git
• curl or wget
• A terminal with bash/zsh

Method 1: Quick Install (Recommended)

curl -fsSL https://get.hermes-agent.ai | bash

This downloads and runs the official installer script.

Method 2: Manual Install via pip

# Install via pipx (recommended for isolation)
pipx install hermes-agent

# Or with pip directly
pip install hermes-agent

Method 3: From Source (Development)

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip install -e .

Post-Installation Setup

1. Run setup wizard:

   hermes setup
   

   This configures your model provider (OpenRouter, Anthropic, OpenAI, etc.), API keys, and toolsets.

2. Verify installation:

   hermes chat -Q -q \"Hello, world!\"
   

3. Start the messaging gateway (for Telegram/Discord):

   hermes gateway install
   hermes gateway start
   

Configuration

Config file: ~/.hermes/config.yaml

• Default model: Set under model.default (e.g., deepseek/deepseek-v4-flash-0731)
• TTS voice: Configure under tts.edge.voice (e.g., ur-PK-AsadNeural for Urdu male)
• Platform toolsets: Enable/disable tools per platform (Telegram, Discord, etc.)

Useful Commands

Command	Description
hermes chat	Interactive chat session
hermes model	Select/switch default model
hermes config	View/edit configuration
hermes skills	Manage skill library
hermes cron	Schedule recurring tasks
hermes gateway status	Check messaging gateway

Resources

• GitHub Repository
• Official Documentation
• Discord Community

---

Last updated: August 2025