Hermes Agent Guide by mystiquemide for Hermes Agent

Step-by-step setup guide for Hermes Agent with OpenRouter, Telegram, Discord and a systemd gateway

What Hermes Agent Guide does

Hermes-agent-guide is a step-by-step written guide to installing and configuring Hermes Agent from Nous Research on Linux, macOS or Windows through WSL. It starts with the official install script, then walks through the setup wizard: choosing OpenRouter as the provider, creating an API key, selecting the free nvidia/nemotron-3-super-120b-a12b model, and choosing a local terminal backend.

Later steps cover session reset settings, creating a Telegram bot with @BotFather and restricting it to your numeric user ID from @userinfobot, adding a Discord bot with the Message Content Intent, running hermes gateway setup, installing the gateway as a systemd service that starts on boot, and setting up FAL AI for image generation. A link points to a separate native Windows setup that uses PowerShell 7. The guide is a plain README of numbered steps.

Key features

WSL, macOS and Linux setup steps
OpenRouter provider and API key walkthrough
Telegram bot creation with @BotFather and user ID restriction
Discord bot setup including Message Content Intent
Gateway installed as a systemd service that starts on boot
Link to a native Windows setup with PowerShell 7

When to use it

Setting up Hermes Agent for the first time with a free OpenRouter model
Connecting Hermes to Telegram or Discord by following numbered steps
Running the Hermes gateway in the background on a Linux server

Who it is for: Beginners installing Hermes Agent who want a linear walkthrough with exact menu choices.

How it fits with Hermes Agent

It is a community tutorial for Hermes Agent by Nous Research and follows the official installer and setup wizard.

How to install Hermes Agent Guide

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

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

Requirements: Linux, macOS or WSL

FAQ

What is Hermes Agent Guide?

Hermes Agent Guide is a community tutorial that walks through setting up Hermes Agent: installation, provider and model selection, a Telegram bot, a Discord bot, the gateway service and image generation.

How do I install Hermes Agent with this guide?

Run the official install script, curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash, then follow the setup wizard steps in the guide. Windows users start with WSL.

Is Hermes Agent Guide free and open source?

Yes. The repository is published under the MIT license.