Skip to content

Commit 171e6cb

Browse files
tcconnallytcconnallyclaude
authored
docs: finish Mimir -> Mneme prose rename in remaining docs (#321)
Code identifiers, GHCR image, repo URLs, and registry metadata were already renamed in #318/#319. This pass covers the product-name prose still saying "Mimir" in awesome-mimir.md, CONTRIBUTING.md, SUPPORT.md, SBOM/federal-buyers/EXPORT-CONTROL docs, the three MCP client integration guides, the three vs-competitor comparison docs, and the four integrations/ READMEs. Deliberately left "mimir"/"Mimir" where it's a real back-compat identifier rather than prose: - mimir_* MCP tool wire names (unchanged, back-compat guaranteed) - ~/.mimir/data/mimir.db path examples (unchanged, back-compat path) - The CLI binary invocation and "mcpServers": {"mimir": {"command": "mimir", ...}} config key — install.sh symlinks mneme -> mimir, so "mimir" is still the primary working command today - PyPI package/module names and classes (mimir_autogen, mimir_crewai, mimir_langgraph, mimir-persist, MimirStore, MimirMemoryTool, MimirMemory) and their real "binary=\"mimir\"" code defaults - docs/SBOM.md's literal crate/component identifiers (crates.io:mimir@2.0.0, Component name: mimir) - External repo name (hermes-mimir-plugin) and this repo's own filenames (awesome-mimir.md, mimir-vs-*.md) Co-authored-by: tcconnally <hermes@perseus.observer> Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
1 parent 59d5657 commit 171e6cb

16 files changed

Lines changed: 130 additions & 130 deletions

File tree

CONTRIBUTING.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
# Contributing to Mimir
1+
# Contributing to Mneme
22

3-
Thanks for wanting to help! Mimir is a Rust MCP server for persistent AI agent
3+
Thanks for wanting to help! Mneme is a Rust MCP server for persistent AI agent
44
memory. Contributions of all kinds are welcome — code, docs, bug reports, feature
55
ideas.
66

77
## Development Setup
88

99
```bash
1010
git clone https://github.com/Perseus-Computing-LLC/mneme.git
11-
cd mimir
11+
cd mneme
1212

1313
# Build (requires Rust 1.70+)
1414
cargo build --release

SUPPORT.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@
1010

1111
## MCP Host Integration
1212

13-
Mimir works with any MCP-compatible host. See the [README](README.md#mcp-configuration)
13+
Mneme works with any MCP-compatible host. See the [README](README.md#mcp-configuration)
1414
for Claude Desktop, Cursor, OpenClaw, and Hermes Agent configuration examples.
1515

1616
## Perseus Integration
1717

18-
If you're using Mimir as the memory backend for Perseus, see the
18+
If you're using Mneme as the memory backend for Perseus, see the
1919
[Perseus docs](https://github.com/Perseus-Computing-LLC/perseus) for the full
2020
`.perseus/config.yaml` setup.

awesome-mimir.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
# Awesome Mimir
1+
# Awesome Mneme
22

3-
> Curated list of Mimir integrations, tools, and resources.
4-
> Mimir is an MCP-native, local-first persistent memory engine for AI agents.
3+
> Curated list of Mneme integrations, tools, and resources.
4+
> Mneme is an MCP-native, local-first persistent memory engine for AI agents.
55
66
## Contents
77

@@ -15,14 +15,14 @@
1515

1616
## Official Resources
1717

18-
- [Mimir GitHub Repo](https://github.com/Perseus-Computing-LLC/mneme) — The Mimir source
18+
- [Mneme GitHub Repo](https://github.com/Perseus-Computing-LLC/mneme) — The Mneme source
1919
- [Roadmap](https://github.com/Perseus-Computing-LLC/mneme/blob/main/ROADMAP.md)
2020
- [Contributing Guide](https://github.com/Perseus-Computing-LLC/mneme/blob/main/CONTRIBUTING.md)
2121
- [Security Policy](https://github.com/Perseus-Computing-LLC/mneme/blob/main/SECURITY.md)
2222

2323
## Framework Integrations
2424

25-
Mimir adapters for popular AI agent frameworks:
25+
Mneme adapters for popular AI agent frameworks:
2626

2727
### LangGraph (LangChain)
2828
- [mimir-langgraph](https://github.com/Perseus-Computing-LLC/mneme/tree/main/integrations/langgraph)`MimirStore` implementing `BaseStore`
@@ -40,15 +40,15 @@ Mimir adapters for popular AI agent frameworks:
4040
- `pip install -e integrations/autogen/`
4141

4242
### Other Frameworks
43-
Mimir is MCP-native — any framework with MCP support can use Mimir directly:
43+
Mneme is MCP-native — any framework with MCP support can use Mneme directly:
4444
- [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) — via MCP stdio
4545
- [Google ADK](https://github.com/google/adk-python) — via MCP stdio
4646
- [Agno](https://github.com/agno-agi/agno) — via MCP stdio
4747
- [Magentic-One](https://github.com/anthropics/anthropic-quickstarts) — via MCP stdio
4848

4949
## MCP Hosts
5050

51-
Mimir works with any MCP host. Configuration is one line:
51+
Mneme works with any MCP host. Configuration is one line:
5252

5353
```json
5454
{
@@ -71,7 +71,7 @@ Tested and confirmed working with:
7171

7272
## Tools & Plugins
7373

74-
### Mimir Itself (36 MCP Tools)
74+
### Mneme Itself (36 MCP Tools)
7575

7676
| Category | Tools |
7777
|---|---|
@@ -88,28 +88,28 @@ Tested and confirmed working with:
8888

8989
### Plugin Ecosystem
9090

91-
- [hermes-mimir-plugin](https://github.com/Perseus-Computing-LLC/hermes-mimir-plugin) — Native Mimir integration for Hermes Agent
92-
- [Perseus Mimir Connector](https://github.com/Perseus-Computing-LLC/perseus) — Perseus live context injection from Mimir
91+
- [hermes-mimir-plugin](https://github.com/Perseus-Computing-LLC/hermes-mimir-plugin) — Native Mneme integration for Hermes Agent
92+
- [Perseus Mneme Connector](https://github.com/Perseus-Computing-LLC/perseus) — Perseus live context injection from Mneme
9393

9494
## Community Projects
9595

9696
*Add your project here! Open a PR to [awesome-mimir.md](https://github.com/Perseus-Computing-LLC/mneme/blob/main/awesome-mimir.md).*
9797

9898
## Articles & Tutorials
9999

100-
*Add articles, blog posts, and tutorials about Mimir.*
100+
*Add articles, blog posts, and tutorials about Mneme.*
101101

102102
## Comparisons
103103

104-
- [Mimir vs Mem0](https://github.com/Perseus-Computing-LLC/mneme/blob/main/docs/comparison/mimir-vs-mem0.md) — Local-first vs cloud-only
105-
- [Mimir vs Letta](https://github.com/Perseus-Computing-LLC/mneme/blob/main/docs/comparison/mimir-vs-letta.md) — Memory engine vs agent runtime
106-
- [Mimir vs Zep](https://github.com/Perseus-Computing-LLC/mneme/blob/main/docs/comparison/mimir-vs-zep.md) — Single binary vs infrastructure
104+
- [Mneme vs Mem0](https://github.com/Perseus-Computing-LLC/mneme/blob/main/docs/comparison/mimir-vs-mem0.md) — Local-first vs cloud-only
105+
- [Mneme vs Letta](https://github.com/Perseus-Computing-LLC/mneme/blob/main/docs/comparison/mimir-vs-letta.md) — Memory engine vs agent runtime
106+
- [Mneme vs Zep](https://github.com/Perseus-Computing-LLC/mneme/blob/main/docs/comparison/mimir-vs-zep.md) — Single binary vs infrastructure
107107

108108
## Key Differentiators
109109

110-
Why Mimir stands out:
110+
Why Mneme stands out:
111111

112-
| Feature | Mimir | Mem0 | Letta | Zep |
112+
| Feature | Mneme | Mem0 | Letta | Zep |
113113
|---|---|---|---|---|
114114
| **MCP-Native** | ✅ 36 tools ||||
115115
| **Local-First** | ✅ Single binary | ❌ Cloud-dependent | ❌ Docker + Postgres | ❌ Docker + Postgres |

docs/EXPORT-CONTROL.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Export Control Self-Classification — Perseus & Mimir
1+
# Export Control Self-Classification — Perseus & Mneme
22

33
**Prepared by:** Perseus Computing LLC
44
**Date:** 2026-06-20
@@ -9,7 +9,7 @@
99

1010
## Executive Summary
1111

12-
Both Perseus (perseus-ctx) and Mimir are **MIT-licensed, publicly available open source software**.
12+
Both Perseus (perseus-ctx) and Mneme are **MIT-licensed, publicly available open source software**.
1313
Under the Export Administration Regulations (EAR) 15 CFR §§ 730-774 and the International
1414
Traffic in Arms Regulations (ITAR) 22 CFR §§ 120-130, both products are self-classified as
1515
**EAR99** — not subject to export licensing requirements.
@@ -26,7 +26,7 @@ This document provides the analysis and rationale for federal procurement and SB
2626
- **Distribution:** PyPI (public package registry)
2727
- **Source:** https://github.com/Perseus-Computing-LLC/perseus (public, MIT license)
2828

29-
### Mimir (v2.0.0)
29+
### Mneme (v2.0.0)
3030
- **Type:** Rust binary — persistent memory MCP server for AI agents
3131
- **Function:** Stores, searches, and retrieves structured entities via JSON-RPC 2.0 over stdio. Includes AES-256-GCM encryption (standard commercial algorithm). Optional embedding via public ONNX models. No cryptographic key management — keys are user-provided.
3232
- **Distribution:** GitHub Releases (public binary downloads)
@@ -39,7 +39,7 @@ This document provides the analysis and rationale for federal procurement and SB
3939
### Jurisdiction: EAR99
4040

4141
Per 15 CFR § 734.3(b), items subject to the EAR include all items in the United States
42-
unless specifically excluded. The following analysis determines whether Perseus or Mimir
42+
unless specifically excluded. The following analysis determines whether Perseus or Mneme
4343
fall under a more restrictive ECCN (Export Control Classification Number).
4444

4545
### ECCN Review
@@ -56,7 +56,7 @@ fall under a more restrictive ECCN (Export Control Classification Number).
5656

5757
### Cryptography Analysis (ECCN 5D002)
5858

59-
Mimir includes AES-256-GCM encryption via the `aes-gcm` Rust crate (v0.10). Under
59+
Mneme includes AES-256-GCM encryption via the `aes-gcm` Rust crate (v0.10). Under
6060
EAR Category 5 Part 2, cryptographic software may require classification under 5D002.
6161

6262
**However**, per 15 CFR § 740.13(b)(1) and Supplement No. 8 to Part 742, "publicly
@@ -66,7 +66,7 @@ available" encryption source code is **not subject to the EAR** when it is:
6666
2. Available for free distribution (MIT license — ✅)
6767
3. Not restricted to specific countries or persons (public repo — ✅)
6868

69-
Both Perseus and Mimir source code are publicly available on GitHub under MIT license.
69+
Both Perseus and Mneme source code are publicly available on GitHub under MIT license.
7070
The AES-256-GCM implementation is via a standard, publicly available open-source crate.
7171
No proprietary or classified encryption algorithms are used.
7272

@@ -85,7 +85,7 @@ countries, 10% for embargoed destinations).
8585
### USML Review
8686

8787
Per 22 CFR § 121.1 (United States Munitions List), ITAR controls apply to defense
88-
articles and services. Neither Perseus nor Mimir:
88+
articles and services. Neither Perseus nor Mneme:
8989

9090
- Are specifically designed, developed, configured, adapted, or modified for a
9191
military application (Category I-XXI)
@@ -120,7 +120,7 @@ open source software, standard EAR99 treatment applies.
120120
| Product | ECCN | ITAR | License Required | Encryption Registration |
121121
|---|---|---|---|---|
122122
| Perseus (perseus-ctx) | EAR99 | Not applicable | No | No |
123-
| Mimir | EAR99 | Not applicable | No | No (public availability exclusion) |
123+
| Mneme | EAR99 | Not applicable | No | No (public availability exclusion) |
124124

125125
---
126126

docs/SBOM.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Mimir SBOM (Software Bill of Materials)
1+
# Mneme SBOM (Software Bill of Materials)
22
## For Federal Procurement Compliance
33

44
**Package:** mimir v2.0.0

docs/comparison/mimir-vs-letta.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
# Mimir vs Letta: Memory Engine vs Agent Runtime
1+
# Mneme vs Letta: Memory Engine vs Agent Runtime
22

33
## Quick Summary
44

5-
| | Mimir | Letta |
5+
| | Mneme | Letta |
66
|---|---|---|
77
| **Stars** | ~20 | ~15K |
88
| **What it is** | Pure memory engine | Full agent runtime with memory |
@@ -18,11 +18,11 @@
1818

1919
## Architecture: Composable vs Monolithic
2020

21-
Mimir is a **pure memory engine** — it does one thing (persistent memory) and
21+
Mneme is a **pure memory engine** — it does one thing (persistent memory) and
2222
composes with any agent framework via MCP stdio. Letta is an **agent runtime**
2323
that includes memory as one component.
2424

25-
### Mimir: Memory as a Service
25+
### Mneme: Memory as a Service
2626

2727
```
2828
CrewAI ──────────┐
@@ -32,8 +32,8 @@ Claude Desktop ──┤ └── SQLite
3232
Cursor ──────────┘
3333
```
3434

35-
Mimir plugs into any MCP host. Your agents can use CrewAI, LangGraph, AutoGen,
36-
or any framework — Mimir is just the memory layer.
35+
Mneme plugs into any MCP host. Your agents can use CrewAI, LangGraph, AutoGen,
36+
or any framework — Mneme is just the memory layer.
3737

3838
### Letta: Everything in One Box
3939

@@ -49,7 +49,7 @@ Letta agents run inside Letta's runtime. The memory is coupled to the agent
4949
framework. You can't use Letta's memory with a CrewAI agent or a Claude Desktop
5050
session.
5151

52-
## When to Use Mimir
52+
## When to Use Mneme
5353

5454
- You want memory that **works with any agent framework**
5555
- You're building agents with CrewAI, LangGraph, AutoGen, or raw MCP
@@ -68,9 +68,9 @@ session.
6868

6969
## Memory Models
7070

71-
### Mimir: Lifecycle-Aware Entities
71+
### Mneme: Lifecycle-Aware Entities
7272

73-
Mimir entities have a full lifecycle:
73+
Mneme entities have a full lifecycle:
7474
- **Ebbinghaus decay** — memories naturally fade unless retrieved
7575
- **Layer promotion** — buffer → working → core based on access patterns
7676
- **Automatic archival** — stale entities archive, recoverable
@@ -91,8 +91,8 @@ a standalone memory service.
9191

9292
## MCP Tools: 36 vs 8
9393

94-
Mimir's 36 MCP tools cover the entire memory surface. Letta exposes ~8 tools
95-
focused on agent state management. Mimir's additional tools enable:
94+
Mneme's 36 MCP tools cover the entire memory surface. Letta exposes ~8 tools
95+
focused on agent state management. Mneme's additional tools enable:
9696

9797
- **mimir_correct** — structured learning from errors
9898
- **mimir_synthesize** — LLM session synthesis
@@ -103,21 +103,21 @@ focused on agent state management. Mimir's additional tools enable:
103103

104104
## Honest Assessment
105105

106-
**Mimir's strengths vs Letta:**
106+
**Mneme's strengths vs Letta:**
107107
- Composable with any framework (not locked into one agent runtime)
108108
- Single binary, no PostgreSQL dependency
109109
- 36 MCP tools vs 8
110110
- Encryption at rest
111111
- Full entity lifecycle management
112112
- MIT license
113113

114-
**Mimir's weaknesses vs Letta:**
114+
**Mneme's weaknesses vs Letta:**
115115
- Letta has a more mature agent platform with advanced features
116116
- Letta's memory block model is well-tested in production
117117
- Letta provides managed cloud hosting (Letta Cloud)
118118
- Larger community and more documentation
119119
- Sandboxed code execution is Letta-native
120120

121-
**If you're choosing today:** Mimir is the better choice if you want memory
121+
**If you're choosing today:** Mneme is the better choice if you want memory
122122
that works with any agent framework. Letta is better if you want a complete
123123
managed agent platform and are willing to commit to Letta's ecosystem.

docs/comparison/mimir-vs-mem0.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
# Mimir vs Mem0: Local-First vs Cloud-Only Memory
1+
# Mneme vs Mem0: Local-First vs Cloud-Only Memory
22

33
## Quick Summary
44

5-
| | Mimir | Mem0 |
5+
| | Mneme | Mem0 |
66
|---|---|---|
77
| **Stars** | ~20 | ~55K |
88
| **Language** | Rust | Python |
@@ -16,7 +16,7 @@
1616
| **License** | MIT | Apache 2.0 |
1717
| **Embeddings** | Optional (Ollama or OpenAI-compatible) | Required (OpenAI default) |
1818

19-
## When to Use Mimir
19+
## When to Use Mneme
2020

2121
- You want a **single binary** with no infrastructure
2222
- You need **fully offline** operation (air-gapped, classified environments)
@@ -36,7 +36,7 @@
3636

3737
## Architecture Differences
3838

39-
### Mimir: Single Binary, No Dependencies
39+
### Mneme: Single Binary, No Dependencies
4040

4141
```
4242
Agent ──MCP stdio── mimir (Rust binary)
@@ -46,7 +46,7 @@ Agent ──MCP stdio── mimir (Rust binary)
4646
└── Web dashboard (optional)
4747
```
4848

49-
Mimir is a self-contained Rust binary. The SQLite database is a single file.
49+
Mneme is a self-contained Rust binary. The SQLite database is a single file.
5050
Install is one `curl | sh`. Nothing else to configure.
5151

5252
### Mem0: Python + External Services
@@ -63,9 +63,9 @@ The "self-hosted" path still needs PostgreSQL, Qdrant, or Neo4j running.
6363

6464
## Memory Models
6565

66-
### Mimir: Structured Entities
66+
### Mneme: Structured Entities
6767

68-
Entities in Mimir have explicit structure:
68+
Entities in Mneme have explicit structure:
6969
- **Category + Key**: Namespaced, idempotent storage
7070
- **Type**: Declared entity type (fact, decision, preference, etc.)
7171
- **Decay**: Ebbinghaus decay with retrieval boosts
@@ -88,9 +88,9 @@ that works well for straightforward RAG use cases.
8888

8989
## MCP Tools: 36 vs 5
9090

91-
Mimir exposes 36 MCP tools covering the full memory lifecycle:
91+
Mneme exposes 36 MCP tools covering the full memory lifecycle:
9292

93-
| Category | Mimir Tools |
93+
| Category | Mneme Tools |
9494
|---|---|
9595
| CRUD | remember, recall, recall_when, get_entity, forget |
9696
| Graph | link, unlink, traverse |
@@ -108,7 +108,7 @@ Mem0 exposes ~5 tools: add, search, get, get_all, delete.
108108

109109
## MCP-Native Advantage
110110

111-
Mimir is MCP-native — the binary IS an MCP server. Connect via stdio, SSE, or HTTP:
111+
Mneme is MCP-native — the binary IS an MCP server. Connect via stdio, SSE, or HTTP:
112112

113113
```json
114114
{
@@ -126,21 +126,21 @@ afterthought, not the native interface.
126126

127127
## Honest Assessment
128128

129-
**Mimir's strengths:**
129+
**Mneme's strengths:**
130130
- Zero-dependency deployment (one binary, one file)
131131
- MCP-native architecture
132132
- Structured memory model with lifecycle management
133133
- Encryption at rest
134134
- Fully offline operation
135135
- MIT license
136136

137-
**Mimir's weaknesses vs Mem0:**
137+
**Mneme's weaknesses vs Mem0:**
138138
- Much smaller community (20 stars vs 55K)
139139
- Requires Rust toolchain to build from source
140140
- No managed cloud offering
141141
- Fewer tutorials and integration examples
142142
- Binary distribution is less familiar to Python developers
143143

144-
**If you're choosing today:** Pick Mimir if you value simplicity, privacy, and
144+
**If you're choosing today:** Pick Mneme if you value simplicity, privacy, and
145145
MCP-native design. Pick Mem0 if you need cloud-managed memory or already have
146146
a Python/PostgreSQL stack.

0 commit comments

Comments
 (0)