Aphrodite Hermes Plugin

What Aphrodite Hermes Plugin does

Per the README, the agent sees about 15 tokens of metadata instead of 500 tokens of raw text and retrieves the full content only when it needs it. The plugin registers 13 tools and 6 hooks, includes a 30-type classifier and an opt-in context engine, and keeps compressed content in a SQLite CCR store. All compression logic lives in the Rust dylib, while the roughly 1,150-line Python loader only loads it over ctypes and registers hooks, tools and the engine with Hermes.

Two proxy processes run locally, on port 9797 for the cache and 9798 for tokens, and the plugin reuses an already-running pair if it finds one. Binaries are never shipped inside the repository: download.sh, or download.ps1 on Windows, fetches them from GitHub Releases and checks SHA-256 against an in-tree list. The plugin never downloads anything on its own. The proxy forwards to an OpenAI-compatible provider, so it needs its own API key even though Hermes already has one configured. The aphrodite_stats tool and a health endpoint confirm it is running.

Key features

• Compact structured previews that replace raw tool output in the context
• 13 tools and 6 hooks registered with Hermes
• A 30-type output classifier and an opt-in context engine
• Dual proxies for cache and token handling on ports 9797 and 9798
• SHA-256 verified binary download through an explicit setup step
• Windows support through download.ps1

When to use it

• Reducing the tokens spent on large tool outputs in long Hermes sessions
• Letting an agent fetch full tool output only when it needs the detail
• Checking compression stats with aphrodite_stats during a session

Who it is for: Hermes Agent users running long, tool-heavy sessions who want to cut the context taken up by raw tool output.

How it fits with Hermes Agent

It is a plugin built for Hermes Agent, linked into ~/.hermes/plugins/ and enabled with hermes plugins enable aphrodite.

How to install Aphrodite Hermes Plugin

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/PlayForm/Aphrodite-Hermes.git
cd Aphrodite-Hermes
ln -s "$(pwd)" ~/.hermes/plugins/aphrodite
bash download.sh

Requirements: An LLM provider API key in APHRODITE_API_KEY, because there is no keyless mode, plus the binaries fetched by download.sh; no Rust toolchain is needed.

Note: The plugin stays disabled until download.sh has fetched the binaries, and there is no keyless mode, so the proxy will not start without APHRODITE_API_KEY.

FAQ