Open Source • MIT License

An agent that
grows with you.

It's not a coding copilot tethered to an IDE or a chatbot wrapper around a single API. It's an autonomous agent that lives on your server, remembers what it learns, and gets more capable the longer it runs.

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

Works on Linux, macOS & WSL2 · No prerequisites · Installs everything automatically

Get started in 60 seconds

1

Install

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

Installs uv, Python 3.11, clones the repo, sets up everything. No sudo needed.

2

Configure

bash
# Interactive setup wizard
hermes setup

# Or choose your model
hermes model

Connect to Nous Portal (OAuth), OpenRouter (API key), or your own endpoint.

3

Start chatting

bash
hermes

That's it. Full interactive CLI with tools, memory, and skills.

4

Go multi-platform (optional)

bash
# Interactive gateway setup wizard
hermes gateway setup

# Start the messaging gateway
hermes gateway

# Install as a system service
hermes gateway install

Walk through connecting Telegram, Discord, Slack, or WhatsApp. Runs as a systemd service.

5

Keep it up to date

bash
hermes update

Pulls the latest changes and reinstalls dependencies. Run anytime to get new features and fixes.

Native Windows support is extremely experimental and unsupported. Please install WSL2 and run Hermes Agent from there.

See it in action

hermes

Features

Lives Where You Do

Telegram, Discord, Slack, WhatsApp, and CLI from a single gateway — start on one, pick up on another.

Grows the Longer It Runs

Persistent memory and auto-generated skills — it learns your projects and never forgets how it solved a problem.

Scheduled Automations

Natural language cron scheduling for reports, backups, and briefings — running unattended through the gateway.

Delegates & Parallelizes

Isolated subagents with their own conversations, terminals, and Python RPC scripts for zero-context-cost pipelines.

Real Sandboxing

Five backends — local, Docker, SSH, Singularity, Modal — with container hardening and namespace isolation.

Full Web & Browser Control

Web search, browser automation, vision, image generation, text-to-speech, and multi-model reasoning.

Tools

40+ built-in — web search, terminal, file system, browser automation, vision, image generation, text-to-speech, code execution, subagent delegation, memory, task planning, cron scheduling, multi-model reasoning, and more.

Platforms

Telegram, Discord, Slack, WhatsApp, Signal, Email, and CLI — all from a single gateway. Connect to Nous Portal, OpenRouter, or any OpenAI-compatible API.

Environments

Run locally, in Docker, over SSH, on Modal, Daytona, or Singularity. Container hardening with read-only root, dropped capabilities, and namespace isolation.

Skills

40+ bundled skills covering MLOps, GitHub workflows, research, and more. The agent creates new skills on the fly and shares them via the open agentskills.io format. Install community skills from ClawHub, LobeHub, and GitHub.

Research

Batch trajectory generation with parallel workers and checkpointing. Atropos integration for RL training. Export to ShareGPT for fine-tuning with trajectory compression.