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

Sign Up on Nous Portal

## 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.