mnemosyne-hermes 3.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. mnemosyne_hermes-3.1.0/PKG-INFO +70 -0
  2. mnemosyne_hermes-3.1.0/README.md +47 -0
  3. mnemosyne_hermes-3.1.0/pyproject.toml +54 -0
  4. mnemosyne_hermes-3.1.0/setup.cfg +4 -0
  5. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/__init__.py +1515 -0
  6. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/audit.py +138 -0
  7. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/cli.py +332 -0
  8. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/hermes_llm_adapter.py +164 -0
  9. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/install.py +184 -0
  10. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/plugin.yaml +27 -0
  11. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes/tools.py +460 -0
  12. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes.egg-info/PKG-INFO +70 -0
  13. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes.egg-info/SOURCES.txt +15 -0
  14. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes.egg-info/dependency_links.txt +1 -0
  15. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes.egg-info/entry_points.txt +5 -0
  16. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes.egg-info/requires.txt +1 -0
  17. mnemosyne_hermes-3.1.0/src/mnemosyne_hermes.egg-info/top_level.txt +1 -0
mnemosyne_hermes-3.1.0/PKG-INFO ADDED
@@ -0,0 +1,70 @@
1
+ Metadata-Version: 2.4
2
+ Name: mnemosyne-hermes
3
+ Version: 3.1.0
4
+ Summary: Mnemosyne memory provider for Hermes Agent — local-first AI memory with SQLite, vector search, FTS5 hybrid ranking, and episodic consolidation.
5
+ Author-email: Abdias J <abdi.moya@gmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/AxDSan/mnemosyne
8
+ Project-URL: Documentation, https://github.com/AxDSan/mnemosyne#readme
9
+ Project-URL: Repository, https://github.com/AxDSan/mnemosyne
10
+ Project-URL: Bug Tracker, https://github.com/AxDSan/mnemosyne/issues
11
+ Keywords: hermes-agent,memory,mnemosyne,ai-agents,local-first,long-term-memory
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Programming Language :: Python :: 3.13
19
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
+ Requires-Python: >=3.10
21
+ Description-Content-Type: text/markdown
22
+ Requires-Dist: mnemosyne-memory>=3.1
23
+
24
+ # Mnemosyne for Hermes Agent
25
+
26
+ Local-first AI memory provider for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
27
+
28
+ Powered by [Mnemosyne](https://github.com/AxDSan/mnemosyne) — SQLite with vector search, FTS5 hybrid ranking, episodic consolidation, temporal knowledge graph, and multi-agent validation. Zero cloud. Zero latency. MIT licensed.
29
+
30
+ ## Quick Start
31
+
32
+ ```bash
33
+ pip install mnemosyne-hermes
34
+ hermes memory setup # select "mnemosyne"
35
+
36
+ # Or manually:
37
+ hermes config set memory.provider mnemosyne
38
+ ```
39
+
40
+ ## Why Mnemosyne
41
+
42
+ - **Local-first.** Your memory lives on your machine. No cloud. No API key. No network calls.
43
+ - **19 tools.** `mnemosyne_remember`, `mnemosyne_recall`, `mnemosyne_sleep`, `mnemosyne_validate`, `mnemosyne_graph_query`, and more.
44
+ - **Hybrid search.** Vector similarity + FTS5 full-text + temporal scoring. Tunable per-query.
45
+ - **Episodic consolidation.** `mnemosyne_sleep` compresses short-term working memory into long-term episodic summaries.
46
+ - **Knowledge graph.** `mnemosyne_triple_add` and `mnemosyne_triple_query` for structured fact storage.
47
+ - **Graph traversal.** `mnemosyne_graph_query` runs multi-hop BFS through linked memories.
48
+ - **Collaborative validation.** `mnemosyne_validate` lets agents attest, update, or invalidate each other's memories.
49
+ - **Cross-agent surface.** `mnemosyne_shared_remember` stores compact metadata visible across agents.
50
+
51
+ ## Configuration
52
+
53
+ No required config. Defaults use `~/.mnemosyne/` for storage. Optional environment variables:
54
+
55
+ | Variable | Default | Description |
56
+ |----------|---------|-------------|
57
+ | `MNEMOSYNE_HOME` | `~/.mnemosyne` | Storage directory |
58
+ | `MNEMOSYNE_DB_PATH` | auto | Custom SQLite path |
59
+ | `MNEMOSYNE_VEC_WEIGHT` | 0.5 | Vector similarity weight |
60
+ | `MNEMOSYNE_FTS_WEIGHT` | 0.3 | Full-text search weight |
61
+ | `MNEMOSYNE_IMPORTANCE_WEIGHT` | 0.2 | Importance score weight |
62
+ | `MNEMOSYNE_AUTO_SLEEP_ENABLED` | false | Auto-consolidate after N turns |
63
+ | `MNEMOSYNE_AUTO_SLEEP_THRESHOLD` | 50 | Turns between auto-consolidation |
64
+ | `MNEMOSYNE_PROFILE_ISOLATION` | false | Separate DB per Hermes profile |
65
+
66
+ ## Links
67
+
68
+ - [Mnemosyne GitHub](https://github.com/AxDSan/mnemosyne) — core library, benchmarks, docs
69
+ - [Hermes Agent Memory Providers](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers) — provider comparison
70
+ - [Hermes Memory Provider Plugins](https://hermes-agent.nousresearch.com/docs/developer-guide/memory-provider-plugin) — developer guide
mnemosyne_hermes-3.1.0/README.md ADDED
@@ -0,0 +1,47 @@
1
+ # Mnemosyne for Hermes Agent
2
+
3
+ Local-first AI memory provider for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
4
+
5
+ Powered by [Mnemosyne](https://github.com/AxDSan/mnemosyne) — SQLite with vector search, FTS5 hybrid ranking, episodic consolidation, temporal knowledge graph, and multi-agent validation. Zero cloud. Zero latency. MIT licensed.
6
+
7
+ ## Quick Start
8
+
9
+ ```bash
10
+ pip install mnemosyne-hermes
11
+ hermes memory setup # select "mnemosyne"
12
+
13
+ # Or manually:
14
+ hermes config set memory.provider mnemosyne
15
+ ```
16
+
17
+ ## Why Mnemosyne
18
+
19
+ - **Local-first.** Your memory lives on your machine. No cloud. No API key. No network calls.
20
+ - **19 tools.** `mnemosyne_remember`, `mnemosyne_recall`, `mnemosyne_sleep`, `mnemosyne_validate`, `mnemosyne_graph_query`, and more.
21
+ - **Hybrid search.** Vector similarity + FTS5 full-text + temporal scoring. Tunable per-query.
22
+ - **Episodic consolidation.** `mnemosyne_sleep` compresses short-term working memory into long-term episodic summaries.
23
+ - **Knowledge graph.** `mnemosyne_triple_add` and `mnemosyne_triple_query` for structured fact storage.
24
+ - **Graph traversal.** `mnemosyne_graph_query` runs multi-hop BFS through linked memories.
25
+ - **Collaborative validation.** `mnemosyne_validate` lets agents attest, update, or invalidate each other's memories.
26
+ - **Cross-agent surface.** `mnemosyne_shared_remember` stores compact metadata visible across agents.
27
+
28
+ ## Configuration
29
+
30
+ No required config. Defaults use `~/.mnemosyne/` for storage. Optional environment variables:
31
+
32
+ | Variable | Default | Description |
33
+ |----------|---------|-------------|
34
+ | `MNEMOSYNE_HOME` | `~/.mnemosyne` | Storage directory |
35
+ | `MNEMOSYNE_DB_PATH` | auto | Custom SQLite path |
36
+ | `MNEMOSYNE_VEC_WEIGHT` | 0.5 | Vector similarity weight |
37
+ | `MNEMOSYNE_FTS_WEIGHT` | 0.3 | Full-text search weight |
38
+ | `MNEMOSYNE_IMPORTANCE_WEIGHT` | 0.2 | Importance score weight |
39
+ | `MNEMOSYNE_AUTO_SLEEP_ENABLED` | false | Auto-consolidate after N turns |
40
+ | `MNEMOSYNE_AUTO_SLEEP_THRESHOLD` | 50 | Turns between auto-consolidation |
41
+ | `MNEMOSYNE_PROFILE_ISOLATION` | false | Separate DB per Hermes profile |
42
+
43
+ ## Links
44
+
45
+ - [Mnemosyne GitHub](https://github.com/AxDSan/mnemosyne) — core library, benchmarks, docs
46
+ - [Hermes Agent Memory Providers](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers) — provider comparison
47
+ - [Hermes Memory Provider Plugins](https://hermes-agent.nousresearch.com/docs/developer-guide/memory-provider-plugin) — developer guide
mnemosyne_hermes-3.1.0/pyproject.toml ADDED
@@ -0,0 +1,54 @@
1
+ [build-system]
2
+ requires = ["setuptools>=60", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "mnemosyne-hermes"
7
+ version = "3.1.0"
8
+ description = "Mnemosyne memory provider for Hermes Agent — local-first AI memory with SQLite, vector search, FTS5 hybrid ranking, and episodic consolidation."
9
+ authors = [{name = "Abdias J", email = "abdi.moya@gmail.com"}]
10
+ license = "MIT"
11
+ readme = "README.md"
12
+ requires-python = ">=3.10"
13
+ keywords = ["hermes-agent", "memory", "mnemosyne", "ai-agents", "local-first", "long-term-memory"]
14
+ dependencies = ["mnemosyne-memory>=3.1"]
15
+ classifiers = [
16
+ "Development Status :: 4 - Beta",
17
+ "Intended Audience :: Developers",
18
+ "Programming Language :: Python :: 3",
19
+ "Programming Language :: Python :: 3.10",
20
+ "Programming Language :: Python :: 3.11",
21
+ "Programming Language :: Python :: 3.12",
22
+ "Programming Language :: Python :: 3.13",
23
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
24
+ ]
25
+
26
+ [project.entry-points."hermes_agent.plugins"]
27
+ mnemosyne = "mnemosyne_hermes:register"
28
+
29
+ [project.scripts]
30
+ mnemosyne-hermes = "mnemosyne_hermes.install:main"
31
+
32
+ [project.urls]
33
+ Homepage = "https://github.com/AxDSan/mnemosyne"
34
+ Documentation = "https://github.com/AxDSan/mnemosyne#readme"
35
+ Repository = "https://github.com/AxDSan/mnemosyne"
36
+ "Bug Tracker" = "https://github.com/AxDSan/mnemosyne/issues"
37
+
38
+ [tool.setuptools.packages.find]
39
+ where = ["src"]
40
+
41
+ [tool.setuptools.package-data]
42
+ mnemosyne_hermes = ["plugin.yaml"]
43
+
44
+ [tool.ruff]
45
+ line-length = 100
46
+ target-version = "py310"
47
+
48
+ [tool.ruff.lint]
49
+ select = ["E", "W", "F", "I", "B", "C4", "UP"]
50
+ ignore = ["E501"]
51
+
52
+ [tool.ruff.format]
53
+ quote-style = "double"
54
+ indent-style = "space"
mnemosyne_hermes-3.1.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+