hermes-agent-rs: developer tool for Hermes Agent

Rust rewrite of Hermes Agent: single static binary, 10 LLM providers, 17 platform adapters, MCP and ACP

What hermes-agent-rs does

hermes-agent-rs is the Lumio Research Rust port of Hermes Agent. The README states a reference baseline of NousResearch/hermes-agent v2026.4.13 and describes the project as v0.1, with about 110,000 lines of Rust across 17 crates. It builds to a single static binary of roughly 16 MB with no Python, pip or Docker, so it can be copied to a small VPS, a Raspberry Pi or an air-gapped server. The install script detects the OS and CPU, and the hermes command opens an interactive session with tools, memory and streaming.

The workspace covers the agent loop and LLM providers, 30+ tool backends with an approval engine, 17 platform adapters including Telegram, Discord, Slack, WhatsApp, Signal and Matrix, an HTTP and WebSocket API server, and terminal backends for local, Docker, SSH, Daytona, Modal and Singularity. It supports MCP and ACP, voice mode, cron, eight memory backends and model switching with /model mid-conversation. A self-evolution engine uses multi-armed bandit model selection, long-task planning and prompt and memory shaping. The hermes serve command runs the API, gateway and cron together.

Key features

Single static binary with no Python, pip or Docker
10 LLM providers with model switching mid-conversation
17 platform adapters, including Telegram, Discord, Slack, WhatsApp, Signal and Matrix
MCP and ACP support, plus voice mode and cron
Terminal backends for local, Docker, SSH, Daytona, Modal and Singularity
hermes serve to run the API, gateway and cron in one process

When to use it

Running a Hermes-style agent on a small VPS or Raspberry Pi without a Python stack
Serving an API for a dashboard UI with hermes serve --no-gateway
Connecting several chat platforms to one agent with hermes gateway start

Who it is for: Developers and operators who want a Hermes Agent-compatible runtime as one compiled binary.

How it fits with Hermes Agent

A Rust rewrite of Hermes Agent that uses the ~/.hermes directory and the hermes command, built against a pinned upstream NousResearch/hermes-agent release.

How to install hermes-agent-rs

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/Lumio-Research/hermes-agent-rs/main/scripts/install.sh | bash
echo "ANTHROPIC_API_KEY=sk-..." >> ~/.hermes/.env
hermes

Requirements: An API key for an LLM provider, for example ANTHROPIC_API_KEY set in ~/.hermes/.env

Note: This is a community port at v0.1, and users of the v0.1.1 release binaries need to build from main or use a newer release to get the fix for strict OpenAI-compatible providers.

FAQ

What is hermes-agent-rs?

hermes-agent-rs is a Rust rewrite of Hermes Agent by Lumio Research. It compiles to a single static binary and includes the agent loop, LLM providers, tools, memory, a platform gateway and a CLI/TUI.

Is hermes-agent-rs the same as Nous Research's Hermes Agent?

No. It is a community port of the Python project, built against NousResearch/hermes-agent v2026.4.13 as its reference baseline, and it is not an official Nous Research release.

How do I install hermes-agent-rs?

Run the install.sh script from the repository with curl and bash, add your API key to ~/.hermes/.env, then run hermes to start an interactive session.