hermes-paperclip-adapter  by NousResearch

Orchestrate advanced AI agents within a workflow platform

Created 2 weeks ago

New!

375 stars

Top 75.8% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a Paperclip adapter for the Hermes Agent, enabling users to integrate Hermes as a managed AI employee within the Paperclip orchestration platform. It allows users to leverage Hermes's extensive capabilities, including its vast toolset and persistent memory, for automated task execution and workflow management.

How It Works

The adapter integrates Hermes Agent into the Paperclip orchestration platform by executing Hermes's command-line interface in a single-query mode (-q). Upon receiving a task from Paperclip, the adapter spawns a Hermes process. Hermes leverages its extensive tool suite (30+ tools), skills, and persistent memory to process the task. Upon completion, Hermes exits, and the adapter captures its output, parses metrics like token usage, and reports results back to Paperclip. Session persistence is maintained across task heartbeats using Hermes's --resume flag, preserving conversation context and tool state.

Quick Start & Requirements

  • Primary install: npm install @nousresearch/paperclip-adapter-hermes
  • Prerequisites: Hermes Agent installed (pip install hermes-agent), Python 3.10+, at least one LLM API key (Anthropic, OpenRouter, or OpenAI).
  • Setup involves registering the adapter in the Paperclip server's adapter registry and creating a Hermes agent within Paperclip via its UI or API.
  • Relevant links: Hermes Agent, Paperclip, Paperclip Docs.

Highlighted Details

  • Leverages Hermes Agent's 30+ native tools, including terminal, file, web, browser, vision, and git.
  • Supports Hermes's 80+ loadable skills system for extended and customizable agent capabilities.
  • Enables persistent memory and session continuity across tasks via FTS5 search and Hermes's --resume flag.
  • Provides multi-provider LLM access, supporting Anthropic, OpenAI, OpenRouter, and Google models.

Maintenance & Community

No specific community channels for the adapter are listed. Links to parent projects: Hermes Agent, Paperclip.

Licensing & Compatibility

MIT License. Compatible with the Paperclip orchestration platform.

Limitations & Caveats

Requires separate installation and configuration of both Hermes Agent and the Paperclip platform. Adapter setup involves direct modification of Paperclip server code. Performance benchmarks or detailed resource footprint estimates are not provided in the README.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
3
Star History
377 stars in the last 15 days

Explore Similar Projects

Feedback? Help us improve.