gotburnout

Hermes Agent: From Installation to Advanced Level

An autonomous AI assistant that lives on your server, learns from every conversation, works 24/7, and communicates via Telegram. Open source, MIT license, free.

⭐ 169K+ GitHub🔓 MIT License🛠️ 87+ Skills🐍 Python

What is Hermes Agent?

Hermes Agent is a program by Nous Research. You install it on a server or your computer and communicate with it via Telegram, Discord, or the terminal. It executes tasks, remembers context, and learns from every conversation.

  • Memory: Remembers you, your preferences, past tasks. Multiple memory layers.
  • Skills: Automatically creates "recipes" for recurring tasks. 87+ built-in skills.
  • Schedule (Cron): Scheduled tasks. Works even while you sleep.
  • Self-learning: Updates memory and skills after each conversation. Gets better every time.
  • Open License (MIT): Free, open source, for any use.
Prerequisites

Minimum requirements for Hermes Agent:

  • Git — installed and configured
  • Internet — stable connection
  • API key — from OpenRouter or another provider

1Install Hermes

Open terminal and paste one command. It will automatically install Python 3.11, Node.js 22, ripgrep, ffmpeg.

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

2Reload Terminal

After installation, reload the terminal so new commands become available.

Terminal
source ~/.zshrc # If using bash: source ~/.bashrc

3Run Setup

The setup wizard will open. Specify the provider, API key, and model. After that, just type hermes in terminal to start chatting!

Terminal
hermes setup
Done! Hermes is installed. Type hermes to start.