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).

CLI version. Text that begins with - (a recall query or an injected message such as --dry-run …) is sent after a -- separator. Use @plur-ai/cli 0.22.0 or later for these queries. A CLI without separator support reads -- as the text itself; every other query is sent exactly as before, and statements / summaries that begin with - go on stdin, which every CLI version reads.

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. Optional env vars:

Variable	Default	Description
`PLUR_PATH`	`~/.plur`	Storage directory
`PLUR_INJECT_MODE`	`fast`	Set to `hybrid` for embedding-based injection (slower, more accurate)

Requirements

Hermes Agent v0.5.0+
Python 3.10+
Node.js 22+ (for CLI, auto-resolved via npx if not installed globally)

License

Apache-2.0

Metadata

Release files for plur-hermes 0.22.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plur-hermes 0.22.1
File	Size	Uploaded	Provenance
plur_hermes-0.22.1.tar.gz	79.8 kB	Oct 22, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for plur-hermes 0.22.1
File	Interpreter	ABI	Platform	Reset
plur_hermes-0.22.1-py3-none-any.whl 41.7 kB Oct 22, 2026 Without provenance	Python 3	none	any	Details

Total release size: 121.6 kB

Release files / plur_hermes-0.22.1.tar.gz

Download URL	plur_hermes-0.22.1.tar.gz
Size	79.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`1aa94e8d3fb5b8f04bc4793ef4a9539c3cccea5eb9015560a7d8f3510120af9f`
BLAKE2b-256 checksum How to use checksums	`65d3efdfdcaa5ad0a347e16c1de519b595caa1fc737cd07e208dc0f7c47edb6a`
Upload date	Oct 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.1`

Release files / plur_hermes-0.22.1-py3-none-any.whl

Download URL	plur_hermes-0.22.1-py3-none-any.whl
Size	41.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ea5b8fef0385aec56123a14788ffba3c82d18fb95b1fd00278d87f88535337ed`
BLAKE2b-256 checksum How to use checksums	`a7e171183d7854e35f49439be88fd75cab29f753eb162ec1a9f75af56e11cf1b`
Upload date	Oct 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.1`

Security for plur-hermes 0.22.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.