Skip to content

docs(memory-providers): add Mnemosyne to provider documentation (#34271)#34356

Open
Bartok9 wants to merge 3 commits into
NousResearch:mainfrom
Bartok9:docs/34271-mnemosyne-provider
Open

docs(memory-providers): add Mnemosyne to provider documentation (#34271)#34356
Bartok9 wants to merge 3 commits into
NousResearch:mainfrom
Bartok9:docs/34271-mnemosyne-provider

Conversation

@Bartok9

@Bartok9 Bartok9 commented May 29, 2026

Copy link
Copy Markdown
Contributor

Closes #34271

Adds Mnemosyne as a community-maintained option in the memory-providers documentation. Per the issue's 'Minimal' acceptance criteria (no Hermes core code changes required), this PR is documentation-only:

  1. Front-matter description, providers inventory line, and config-yaml example updated.
  2. Full provider section added under ### Memori with best-for / requires / storage / cost block, all 19 tools listed, setup snippet (pip install + plugin symlink + provider selection), key capabilities summary, and lifecycle-integration audit (which optional hooks are implemented vs not).
  3. Mnemosyne row added to the Provider Comparison table with a footnote distinguishing community-maintained from bundled.

The 'community-maintained' framing is intentional: the issue requested visibility, not promotion to first-party. The plugin-discovery system already supports user-installed providers via $HERMES_HOME/plugins/, so documentation was the only blocker.

🎻 Co-authored-by: Cursor cursoragent@cursor.com

…Research#34271)

Mnemosyne is a community-maintained Hermes memory provider plugin
that fills a documented gap in the bundled provider set:

- Largest tool surface of any provider (19 tools vs Honcho's 5).
- Only provider with hybrid semantic + FTS5 + temporal ranking in one
  query.
- Only fully-local provider (beyond Holographic/ByteRover) with vector
  search, full-text search, and a knowledge graph in one engine.
- Free + MIT + no API key + no quotas + no network egress.

Per the issue's 'Minimal' acceptance criteria (no Hermes core code
changes required), this PR:

1. Adds Mnemosyne to the front-matter description, the providers
   inventory line ('9 external memory provider plugins + 1 community
   provider'), and the example config-yaml comment.
2. Adds a full provider section under ### Memori with:
   - Best-for / Requires / Storage / Cost block
   - All 19 tools listed
   - Setup snippet showing pip install + plugin symlink + provider
     selection
   - Key capabilities summary
   - Lifecycle integration audit (which optional hooks are
     implemented vs not)
   - Explicit community-maintained status note pointing bug reports
     to the Mnemosyne project.
3. Adds a Mnemosyne row to the Provider Comparison table with a
   footnote distinguishing it from bundled providers.

The 'community-maintained' framing is intentional: the issue's
request was visibility, not promotion to first-party. The plugin-
discovery system already supports user-installed providers via
$HERMES_HOME/plugins/, so documentation is the only blocker.

Refs: NousResearch#34271
Closes: NousResearch#34271

Co-authored-by: Cursor <cursoragent@cursor.com>
@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have comp/plugins Plugin system and bundled plugins tool/memory Memory tool and memory providers labels May 29, 2026
@AxDSan

AxDSan commented May 29, 2026

Copy link
Copy Markdown
Contributor

I've closed #34679 in favor of this PR — credit where it's due for submitting first.

I've layered the cross-reference updates (overview.md, memory.md, integrations/index.md + zh-Hans translations + stale '8 providers' fix) onto @Bartok9's branch via Bartok9/hermes-agent#2.

If @Bartok9 merges that in, this PR will have both: the core Mnemosyne section + the cross-reference hygiene. One merge, everything clean.

AxDSan and others added 2 commits May 29, 2026 17:42
…s (+ zh-Hans) (#2)

Adds Mnemosyne (and Memori) to the cross-reference lists in:
- website/docs/integrations/index.md
- website/docs/user-guide/features/overview.md
- website/docs/user-guide/features/memory.md
- website/i18n/zh-Hans/ integrations/index.md (zh-Hans)
- website/i18n/zh-Hans/ overview.md (zh-Hans)

Replaces stale '8 providers' wording with 'supported providers' for
lower maintenance overhead.

Co-authored-by: Bartok <bartok9@users.noreply.github.com>
The Mnemosyne cross-reference merge (#2) accidentally pulled in a local
CodeGraph tooling artifact (.codegraph/.gitignore) that is unrelated to
the docs change. Remove it to keep this PR scoped to documentation only.
@Bartok9

Bartok9 commented Jun 6, 2026

Copy link
Copy Markdown
Contributor Author

Combined with @AxDSan's cross-reference additions + scope cleanup

Thanks to @AxDSan for the excellent follow-up — they opened a PR against this branch (Bartok9/hermes-agent#2) layering in the cross-reference updates this docs change was missing. I've merged it in, so this PR now covers:

Original (this PR):

Added by @AxDSan (credit to them):

  • Cross-references Mnemosyne in features/overview.md, features/memory.md, and integrations/index.md so it's discoverable from every place the other providers are listed.
  • Fixes the stale "Eight providers" count in integrations/index.md — now an explicit list ending in "…Supermemory, Memori, and Mnemosyne" rather than a hard-coded number that drifts every time a provider is added.
  • Mirrors the changes into the zh-Hans translations (integrations/index.md, features/overview.md) so the localized docs stay in sync.

One cleanup from me: the merge accidentally pulled in a stray local CodeGraph tooling artifact (.codegraph/.gitignore). I dropped it in a follow-up commit so this PR stays strictly documentation-only.

Net result: 6 files, docs-only, all green, mergeable: MERGEABLE. The change is now complete and consistent across English + zh-Hans. Ready for maintainer review/merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/plugins Plugin system and bundled plugins P3 Low — cosmetic, nice to have tool/memory Memory tool and memory providers type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Proposal: Add Mnemosyne to official memory provider documentation

3 participants