prismer-adapter-hermes

Prismer PARA (Prismer Agent Runtime ABI) adapter for Hermes agents by NousResearch.

This is the first Python adapter in the Prismer SDK family.

What It Does

Translates all 14 Hermes hook events to PARA v0.1 event format and writes them to ~/.prismer/para/events.jsonl. The Prismer PARA runtime daemon reads this file to power the Evolution engine, mobile dashboards, and cross-agent memory.

Install

pip install prismer-adapter-hermes

Zero runtime dependencies — the wire types are vendored as pure dataclasses.

Basic Usage

In your Hermes plugin configuration, set the plugin module to prismer_adapter_hermes.register. Hermes calls register(ctx) automatically on plugin load.

# hermes_plugin.py — your Hermes plugin file
from prismer_adapter_hermes import register

# Hermes calls this at startup
def setup(ctx):
    register(ctx)

Or call it directly with a custom sink:

from prismer_adapter_hermes import register, default_jsonl_sink

def setup(ctx):
    adapter = register(ctx, sink=default_jsonl_sink)
    # adapter is a HermesParaAdapter instance

14 Hook Mappings (§4.6.2)

pre_llm_call — Cache-Safe Context Injection (P11 Pattern)

pre_llm_call is Hermes's standout capability and PARA's P11 Pattern. The adapter's on_pre_llm_call method accepts an additional_context parameter and returns {"context": additional_context}.

Hermes injects this context string into the tail of the current user message — not into the system prompt. This preserves the prompt cache across turns because the system prompt block never changes.

# Hermes calls your handler like:
#   result = handler(ctx)
# If result["context"] is non-empty, Hermes appends it to the current user message.

# The adapter does this automatically when additional_context is provided:
adapter.on_pre_llm_call(ctx, additional_context="[prismer memory hint: ...]")
# → emits agent.llm.pre PARA event
# → returns {"context": "[prismer memory hint: ...]"}

Observability

Events are appended to ~/.prismer/para/events.jsonl (one JSON object per line). Set PRISMER_PARA_STDOUT=1 to also print events to stdout (useful in dev).

PRISMER_PARA_STDOUT=1 python -m hermes_agent run

Links

• PARA Spec §4.6.2 — Hermes 14 hook mappings
• Prismer Cloud
• Hermes Agent