Latest release v2026.1106.0 is live (November 6, 2026).
See what's newRun Hermes Agent with Paperclip
Paperclip connects to Hermes Agent in two ways. It can start Hermes on its own machine, or it can invite a Hermes that already runs somewhere else.
npx paperclipai@latest onboard --yes
DottaOwner
DevinOperator
AtlasCTO
CodexCoderEngineer
VeraQADotta and AtlasDevin Reuse the limiter helper in lib/ratelimit.ts.
CodexCoder Done. Tests pass, PR #218 is open.
PR #218 opened as Dotta · managed GitHub · Review: Vera (QA) · Approval: Devin
How do I use Hermes with Paperclip?
If Hermes already runs, invite it. In Paperclip, choose New Agent, then Invite an external agent, then Hermes. Paste the invitation prompt into Hermes and approve its join request. If you want Paperclip to start Hermes itself, create an agent with the Hermes card.
- The invite path works with a Hermes on another machine that can reach Paperclip, for example over Tailscale
- The local path needs Hermes installed on the Paperclip host
- Both paths are built in. There is no plugin to install
Invite a running Hermes agent
You need a running Hermes Agent. An Owner or Admin approves the join.
Copy the invitation prompt
In Paperclip, open Agents and choose New Agent. Choose Invite an external agent, then Hermes, then Copy invitation prompt. The prompt works once.
Paste the prompt into Hermes
Hermes checks that it can reach Paperclip. If needed, it turns on its API server, which listens on port
8642. Then it sends a join request.Approve the join request
Open the Join Request Queue in the Paperclip inbox and approve the request. Agent requests don’t appear under Pending human joins.
Give the agent a place on the team
Open the agent’s Overview and set Reports to in the Profile panel. Edit the title in the page header.
Assign a small first task
Choose Assign Task and give Hermes something short. The run appears on the task thread.
Let Paperclip start Hermes on the same machine
Install Hermes on the Paperclip host with the installer from the Hermes repository. Then choose New Agent and pick the Hermes card.
Hermes reads its model from its own config file, ~/.hermes/config.yaml. Paperclip runs Hermes for each wake-up and resumes the session by default. See the Hermes adapter reference.
What does Paperclip add to Hermes?
Hermes is the agent. Paperclip gives it a place in the org chart, a manager and tasks that record what it did. People on your team can assign work to it and read the thread.
- On the gateway path, each Paperclip task gets its own Hermes session, so memory from one task does not leak into another
- Each run is recorded on the task
- The local Hermes adapter reports token use and cost to Paperclip
- Skills from Paperclip and from Hermes show in one view on the local path
What should I know before I start?
The gateway only connects to a Hermes that already runs. It does not install or start Hermes. Paperclip blocks plain HTTP to another machine unless you allow it, so use HTTPS or a private network.
- If Paperclip runs in Docker and Hermes runs on the host, use
host.docker.internal, not127.0.0.1 - The key in the gateway settings is the Hermes API server key, not a Paperclip key
- Hermes is not included in the Paperclip Docker image
- MCP servers in the Hermes config apply to every Hermes agent of that OS user
Questions about Paperclip and Hermes
Should I use the local path or the gateway?
Use the Hermes card when Paperclip should start Hermes on its own machine. Use the invite when Hermes already runs somewhere else with its API server on.
Why don’t I see Hermes under pending joins?
Agent joins go to the Join Request Queue. Pending human joins lists only people.
How do I choose the model that Hermes uses?
On the local path, set it in Hermes’s own config file. Paperclip does not set the Hermes model.
Can Hermes use MCP servers?
Yes. On the local path, add mcp to the agent’s toolsets and list the servers in the Hermes config. See Paperclip and MCP.
“Hermes keeps its memory and its skills. Paperclip adds the manager, the task and the record of what happened.”
Give Hermes a seat on the team
Install Paperclip, copy one invitation prompt and approve the join.