plur-hermes

Persistent memory plugin for Hermes Agent. Your agent corrected on Monday remembers on Tuesday.

Install

pip install plur-hermes

That's it. The plugin is auto-discovered by Hermes on startup. No other install needed.

What happens

Once installed, PLUR runs invisibly in the background:

Every turn: relevant memories are injected into the agent's context (via pre_llm_call hook)
Every response: corrections and insights are captured automatically (via post_llm_call hook)
Every session: episodes are recorded to a timeline (via on_session_end hook)

The agent also gets 22 tools it can call explicitly:

Tool	What it does
`plur_learn`	Store a correction, preference, or pattern
`plur_recall`	Search memories by topic
`plur_inject`	Get relevant context for a task
`plur_list`	List all stored engrams
`plur_forget`	Retire outdated knowledge
`plur_feedback`	Rate a memory (trains what surfaces next time)
`plur_capture`	Record an episode
`plur_timeline`	Query past episodes
`plur_status`	Health check
`plur_sync`	Cross-device sync via git
`plur_packs_list`	List installed knowledge packs
`plur_packs_install`	Install a community knowledge pack
`plur_packs_export`	Export a pack to a shareable file
`plur_extract_meta`	Distill cross-domain principles from your memories
`plur_meta_engrams`	List extracted meta-engrams
`plur_meta_submit_analysis`	Continue multi-turn extraction
`plur_validate_meta`	Test a principle against a new domain
`plur_ingest`	Ingest a message into the memory pipeline
`plur_promote`	Promote an engram to higher confidence
`plur_similarity_search`	Embedding-based similarity search
`plur_stores_add`	Register an additional engram store
`plur_stores_list`	List all registered stores

How it works

Knowledge is stored as engrams — small assertions that strengthen with use and decay when irrelevant. Storage is plain YAML on disk at ~/.plur/. Search is fully local (BM25 + embeddings). Zero API calls, zero cloud, works offline.

The plugin calls the PLUR CLI under the hood via subprocess. If the CLI isn't installed globally, it auto-resolves via npx on first use (cached after that).

What makes PLUR different from Hermes built-in memory

Hermes has MEMORY.md (2,200 chars) and session search (FTS5). PLUR adds:

Feedback-trained retrieval — rate memories, good ones surface more, bad ones fade
Forgetting — retire outdated knowledge instead of growing forever
Hybrid search — BM25 + local embeddings + Reciprocal Rank Fusion
Cross-device sync — git-based, works across machines
Meta-engram extraction — distill transferable principles across domains
Knowledge packs — share curated engrams between agents

PLUR sits alongside Hermes memory, not replacing it. Your MEMORY.md and USER.md continue to work as before.

Configuration

The plugin works with zero configuration and is auto-discovered on startup. You can also register it explicitly as a first-class memory provider in your Hermes config.

Integration paths

PLUR integrates via two paths — both coexist and can be used together:

Path 1: Auto-discovery (default)

Once installed, the plugin is auto-discovered by Hermes via hermes_agent.plugins discovery. No additional configuration needed.

Path 2: Explicit memory provider (v0.19.0+)

For Hermes v0.19.0+ (Herald Release), register PLUR as an explicit memory provider in your hermes-config.json or equivalent:

{
  "memory": {
    "provider": "plur",
    "config": {
      "inject_mode": "fast"
    }
  }
}

This gives PLUR first-class status in your agent's memory system. Both paths can coexist — if both are active, both injection and learning pipelines run.

Environment variables

Variable	Default	Description
`PLUR_PATH`	`~/.plur`	Storage directory
`PLUR_INJECT_MODE`	`fast`	Injection strategy: `fast` (BM25 only, <100ms) or `hybrid` (BM25 + embeddings, ~500ms, more accurate). Embeddings are computed locally; no external APIs.

The memory.provider: plur config's inject_mode field overrides PLUR_INJECT_MODE if both are set.

Requirements

Hermes Agent v0.5.0+ (MemoryProvider path requires v0.19.0+ Herald Release)
Python 3.10+
Node.js 18+ (for CLI, auto-resolved via npx if not installed globally)

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plur_hermes-0.19.2.tar.gz (68.4 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

plur_hermes-0.19.2-py3-none-any.whl (37.5 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file plur_hermes-0.19.2.tar.gz.

File metadata

Download URL: plur_hermes-0.19.2.tar.gz
Upload date: Aug 30, 2026
Size: 68.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for plur_hermes-0.19.2.tar.gz
Algorithm	Hash digest
SHA256	`5b5fdd39a32eb92ca75f38684be59b12101c8e32b398541b86d6902166a563c5`
MD5	`5d1d577925f9ad398fffe67309525df0`
BLAKE2b-256	`4a5ae3a49b789d13dd6f731915cf5a825400a05f64bc8445b8cff217bbb9b1e8`

See more details on using hashes here.

File details

Details for the file plur_hermes-0.19.2-py3-none-any.whl.

File metadata

Download URL: plur_hermes-0.19.2-py3-none-any.whl
Upload date: Aug 30, 2026
Size: 37.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for plur_hermes-0.19.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`a7a1a0cbaf7e7d6a79fcfdd297f16d587af9ba09bc8882fc93efe5f39a3c0c37`
MD5	`427a1cbf768dbfb936a5c3425acedc80`
BLAKE2b-256	`ae7f961c4e16b6b62f3a7e5becb74edfcc87c8df6ebd2438a468fa84a573c128`