Icarus: plugin for Hermes Agent

Hermes plugin for shared agent memory, training-data extraction and model replacement

What Icarus does

Icarus writes agent notes as markdown files into a shared directory set by FABRIC_DIR, so agents on different Hermes profiles can read each other's work. Hooks capture decisions automatically and inject context. Tools such as fabric_recall, fabric_write, fabric_search, fabric_pending and fabric_curate handle ranked retrieval, writing with linking and evidence fields, keyword search, assigned work, and a training_value tag of high, normal or low. Optional Obsidian support adds wikilinks and daily notes, and the fabric_init_obsidian tool sets up a vault.

The training side turns tagged entries into fine-tuning pairs with quality filtering and weighting. export-training.py writes a together.jsonl file for Together AI, with the aim of fine-tuning a cheaper model on your agent's own history, evaluating it and switching to it. The README shows /plugins listing icarus v0.3.0 with 16 tools and 4 hooks, and states that Icarus is not an orchestration framework, agent router or dashboard.

Key features

Shared markdown memory across Hermes profiles through FABRIC_DIR
Hooks that auto-capture decisions and inject context
Recall, write, search, pending and curate tools
training_value tagging to keep noise out of training data
Export of fine-tuning pairs for Together AI
Optional Obsidian wikilinks and daily notes

When to use it

Let two Hermes profiles read each other's decisions and reviews
Browse an agent's notes as an Obsidian vault
Build a training set from an agent's history to fine-tune a cheaper replacement model

Who it is for: Hermes Agent users who run several profiles or want to turn an agent's work history into training data.

How it fits with Hermes Agent

Built as a Hermes plugin that installs into ~/.hermes/plugins/icarus and adds tools and hooks to Hermes.

How to install Icarus

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/esaradev/icarus-plugin.git
mkdir -p ~/.hermes/plugins/icarus
cp -r icarus-plugin/* ~/.hermes/plugins/icarus/

Requirements: Hermes Agent with the FABRIC_DIR variable set in the profile .env file. TOGETHER_API_KEY is needed only for the training and evaluation tools, and Obsidian is optional.

FAQ

What is Icarus?

Icarus is a Hermes plugin for shared agent memory and model replacement. It stores notes as markdown, tags their training value and exports fine-tuning data.

Does Icarus work with Hermes Agent?

Yes, it is a Hermes plugin. You copy it into ~/.hermes/plugins/icarus, start Hermes, and type /plugins to confirm it is loaded.

How do I install Icarus?

Clone the repository, create ~/.hermes/plugins/icarus, and copy the repository files into it. Then set FABRIC_DIR in your Hermes profile .env file and start hermes chat.