explaingit

williambryk/paperclip-adapter

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

TLDR

A TypeScript connector that lets Hermes Agent, an AI agent with 30+ built-in tools and persistent memory, run inside the Paperclip platform, which manages AI agents like company employees and tracks their assigned tasks.

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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

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.

Tech stack

TypeScriptNode.jsPython

Getting 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.

In plain English

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.
Open on GitHub → Explain another repo

← williambryk on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.