maxpaperclips/paperclip-adapter

This project is a small piece of glue code that connects two separate AI tools together. The first tool is called Paperclip, which is a system for running AI workers as if they were employees inside a make-believe company. The second tool is Hermes Agent, an AI agent built by a group called Nous Research. Hermes Agent comes with more than thirty built-in tools (such as terminal access, file editing, web browsing, and image vision), a memory that carries over between sessions, and the ability to load extra skills from a folder on the user's machine. The adapter, written in TypeScript, lets a Paperclip company hire a Hermes Agent and assign it work. When a task is created in Paperclip and given to the Hermes worker, the adapter starts up the Hermes command-line program in single-query mode, hands it the task instructions, and waits for it to finish. The README says the adapter supports eight inference providers, including Anthropic, OpenAI, OpenRouter, and several others, so the user can pick which model the agent runs on. A chunk of the work the adapter does is cleaning up the output. Hermes prints results with ASCII banners, setext headings, and plain-text table borders, and the adapter rewrites all of that into standard markdown so it looks right inside Paperclip's interface. It also parses the raw output into typed entries, so each tool call shows up as its own card with a status icon. Routine startup messages that would otherwise look like errors get reclassified as benign. There are a few quality-of-life touches. The agent can wake up to respond to comments on issues, not only to fresh task assignments. It reads the user's Hermes config file to fill in the model name automatically. Sessions can be resumed across heartbeats, and there is an optional checkpoint mode for rolling back filesystem changes. Installation is a normal npm package, with Hermes itself installed separately through pip, plus at least one API key for the chosen model provider. To register the adapter, the user adds a short import block to their Paperclip server's adapter registry, then creates an agent in the Paperclip UI with the adapter type set to hermes_local. The README also lists configuration fields for timeouts, enabled toolsets, prompt templates, and similar settings.