What is paperclip-adapter?

williambryk/paperclip-adapter — explained in plain English

Analysis updated 2026-06-24

★ 21TypeScriptAudience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((paperclip-adapter))
    What it does
      Bridges Paperclip and Hermes
      Translates output formats
    Platforms connected
      Paperclip task management
      Hermes Agent tools
    Features
      Session state persistence
      Comment-triggered wakeup
      Filesystem snapshots
    Configuration
      8 AI providers
      Timeout settings
      Toolset selection
    Setup
      npm install
      pip install Hermes

mindmap root((paperclip-adapter)) What it does Bridges Paperclip and Hermes Translates output formats Platforms connected Paperclip task management Hermes Agent tools Features Session state persistence Comment-triggered wakeup Filesystem snapshots Configuration 8 AI providers Timeout settings Toolset selection Setup npm install pip install Hermes

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Connect Hermes Agent to Paperclip so AI agents automatically execute tasks assigned through Paperclip's employee-style interface.

USE CASE 2

Set up an AI agent that wakes up and processes a Paperclip task whenever a team member leaves a comment, without manual intervention.

USE CASE 3

Run multi-step file editing, web browsing, and terminal tasks through Hermes inside Paperclip with session state preserved across restarts.

USE CASE 4

Switch the underlying AI model between Anthropic, OpenAI, OpenRouter, or five other providers without changing your Paperclip workflow.

What is it built with?

TypeScriptNode.jsPython

How does it compare?

	williambryk/paperclip-adapter	ame-x/auto-ppt	dj931567261/app-test-control
Stars	21	21	21
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	moderate	moderate	hard
Complexity	3/5	2/5	4/5
Audience	developer	vibe coder	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires both npm (for the adapter) and pip (for Hermes Agent) to be installed and configured before use.

No license information is mentioned in this repository.

So what is it?

This repository is a connector between two AI-related platforms: Paperclip and Hermes Agent. Paperclip is a service for managing AI agents as if they were employees in a company, assigning them tasks and tracking their work. Hermes Agent is a separate AI agent developed by Nous Research that comes with over 30 built-in tools (for browsing the web, working with files, running terminal commands, and more), persistent memory across sessions, and support for multiple AI model providers. The adapter makes it possible to run a Hermes Agent inside Paperclip's environment. Without this connector, the two systems would not know how to talk to each other. With it, you can create an agent in Paperclip, assign it a task, and have Hermes Agent do the actual work, reporting results back to Paperclip when finished. The agent can also wake up when someone leaves a comment on a task, not just when a task is first assigned. The technical work the adapter does includes translating Hermes's raw text output into structured entries that Paperclip can display with proper formatting, cleaning up Hermes's ASCII-style banners and table borders into standard markdown, and keeping session state so that each run picks up where the last one left off. It also handles cases where Hermes logs messages to the error output that are not actually errors, so they do not show up as failures in Paperclip's interface. Configuration covers which AI model and provider to use (eight providers are supported, including Anthropic, OpenAI, and OpenRouter), how long to let the agent run before stopping it, whether to save filesystem snapshots for rollback, and which toolsets to give the agent access to. Installation is through npm, and Hermes Agent must be installed separately via pip before the adapter can function. The project is written in TypeScript.

Copy-paste prompts

Prompt 1

I've installed paperclip-adapter. Walk me through configuring it to use Anthropic Claude as the model provider and assigning it a Paperclip task that edits a file.

Prompt 2

Set up paperclip-adapter so that Hermes Agent wakes up and handles a task automatically when someone adds a comment in Paperclip.

Prompt 3

How do I enable filesystem snapshots in paperclip-adapter so I can roll back changes if the agent makes a mistake during a task?

Prompt 4

I want to limit which tools Hermes Agent has access to when running inside Paperclip. Show me how to configure the toolset in paperclip-adapter.

Frequently asked questions