Nous Research's self-improving AI agent with cross-session memory, multi-platform messaging, serverless deployment, and a closed skill-learning loop.
Before you start
Python 3.11+ and pip. A gateway API key for your preferred messaging platform (Telegram is the simplest to start). An LLM provider key, OpenRouter covers 200+ models with one key. Clone the repo and run the installer.
Clone the repo and run the installer script. Choose your gateway. Telegram is the fastest to set up: create a bot via BotFather, get the token, and pass it to hermes gateway. The agent is immediately reachable from your phone or any Telegram client.
Hermes routes to any of 200+ models via OpenRouter. Use a fast cheap model for quick tasks and a powerful one for complex reasoning. The switch takes one command and persists for the session.
Hermes has a built-in cron scheduler. Define tasks that run on a schedule without you present, daily reports, monitoring checks, or periodic data pulls. Tasks run in the background and surface results to your gateway.
Hermes stores every conversation turn in SQLite with FTS5 full-text search. Ask the agent to recall past context. It searches across all sessions, not just the current one. This is how SONA self-learning works: patterns from past sessions inform current behavior.
For tasks needing isolation, running untrusted code, spinning up a fresh environment, or deploying to serverless, Hermes supports 7 backends: local, Docker, SSH, Singularity, Modal, Daytona, and Vercel Sandbox. Select the backend per task without changing agent code.
Core Hermes Agent commands for gateway, model routing, cron, memory, and execution backends.
| Command / Skill | What it does | When to use it |
|---|---|---|
hermes gateway | Start the messaging gateway for a platform: telegram, discord, slack, whatsapp, signal, or cli | First command, choose your primary interface before doing anything else |
hermes model | Switch active LLM provider/model, supports 200+ via OpenRouter | Changing from a fast/cheap model to a powerful one for complex reasoning tasks |
hermes cronadvanced | Schedule automated tasks using cron expressions, runs unattended in the background | Recurring workflows: daily reports, monitoring checks, periodic data pulls |
SONA self-learningadvanced | Closed skill-learning loop that creates and improves skills from successful task runs | Active automatically, review hermes skills list periodically to audit learned behaviors |
hermes memory search | FTS5 full-text search across all past session conversations | Recalling decisions, steps, or context from previous sessions without re-explaining |
Execution backendsadvanced | 7 backends (local/Docker/SSH/Singularity/Modal/Daytona/Vercel Sandbox) selected per task | Isolated execution for untrusted code, fresh environments, or serverless deployment |