hermes-gpt: MCP tool for Hermes Agent

Local-first MCP sidecar that exposes selected Hermes Agent capabilities to trusted MCP clients

What hermes-gpt does

hermes-gpt runs next to Hermes Agent and presents a connector surface of 137 tools to trusted MCP clients; the repository description pitches it as ChatGPT with keys to your machine. Work is organized into Missions with plans, Work Contracts, delegation, budgets and live events. Version 0.14.0 adds declared artifact checks, such as minimum and maximum file sizes and expected SHA-256 digests, plus recovery when delivered files fail those checks.

Version 0.13.0 added Autopilot, a default-off runtime that drives one Mission through its plan. Its three tools, hermes_autopilot_start, hermes_autopilot_status and hermes_autopilot_stop, exist only when HERMES_GPT_AUTOPILOT=1. Autopilot never crosses approval boundaries, and only an Owner-mode hermes_mission_approve can complete a Mission. A Flight Deck panel gives read-only supervision. The README states the deployment posture is local-dev or trusted-machine only, and the package needs Python 3.10 or newer.

Key features

MCP connector surface of 137 tools when Autopilot is off
Missions with plans, Work Contracts, delegation, budgets and live events
Optional Autopilot with start, status and stop tools, gated by an environment variable
Declared artifact requirements with size limits and SHA-256 digests
Flight Deck read-only supervision panel

When to use it

Letting an MCP client drive a local Hermes Agent on a trusted machine
Running multi-step Missions with capped concurrency, attempts and budgets
Checking that delegated work produced the files it promised before accepting it

Who it is for: Developers and operators who want to control a local Hermes Agent from an MCP client on a machine they trust.

How it fits with Hermes Agent

Built for Hermes Agent as a sidecar. It exposes selected Hermes capabilities over MCP and does not modify Hermes Agent source files.

How to install hermes-gpt

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install hermes-gpt

Requirements: Python 3.10+, MCP SDK 1.28.1+ or 2.x

Note: The README states deployment is local-dev or trusted-machine only, with remote public hosting unsupported.

FAQ

What is hermes-gpt?

hermes-gpt is an MCP sidecar for Hermes Agent. It lets trusted MCP clients use selected Hermes capabilities, organized around Missions, Work Contracts and an optional Autopilot runtime.

How do I install hermes-gpt?

Install it from PyPI with pip install hermes-gpt. The README says the PyPI badge is the source of truth for which version that installs, and Autopilot needs version 0.13.0 or newer.

Is it safe to expose hermes-gpt to the internet?

No. The README lists the deployment posture as local-dev or trusted-machine only and says remote public hosting is unsupported without a real authenticated private boundary.