hermes-plugin-qdrant-memory 0.3.0__tar.gz → 0.5.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.
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/PKG-INFO +41 -23
- hermes_plugin_qdrant_memory-0.3.0/hermes_plugin_qdrant_memory.egg-info/PKG-INFO → hermes_plugin_qdrant_memory-0.5.0/README.md +36 -45
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/docs/local-embedding.md +10 -7
- hermes_plugin_qdrant_memory-0.3.0/README.md → hermes_plugin_qdrant_memory-0.5.0/hermes_plugin_qdrant_memory.egg-info/PKG-INFO +63 -22
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/SOURCES.txt +62 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/requires.txt +5 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/pyproject.toml +3 -2
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/cli.py +28 -2
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/config.py +11 -3
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/dedupe.py +43 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/embedding.py +3 -1
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/extraction.py +121 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/ledger.py +59 -5
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/local_embedding.py +2 -1
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/local_model.py +4 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/mcp_server.py +11 -4
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/native_owner.py +264 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/owner_lifecycle.py +243 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/owner_llm.py +168 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/ownership.py +115 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/plugin.yaml +4 -1
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/policy_admin.py +93 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/provider.py +189 -4
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/qdrant_store.py +7 -2
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/quality_metrics.py +254 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_client.py +180 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_gateway.py +317 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_protocol.py +46 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/runtime.py +53 -4
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_client.py +93 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_protocol.py +46 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_reader.py +227 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_recall.py +166 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_security.py +365 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_service.py +701 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_state.py +45 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/standalone.py +417 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/tools.py +21 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/version.py +1 -1
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/requirements-local.txt +232 -234
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/requirements.txt +3 -3
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/scripts/demo.sh +1 -1
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/helpers.py +21 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/remote/fixture.py +343 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/security/__init__.py +1 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/security/test_cloud_owner.py +191 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/security/test_cloud_owner_cleanup.py +122 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/security/test_device_server.py +98 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/security/test_shared_security.py +520 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/security/test_shared_security_live.py +115 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_admission_control.py +65 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_device_grants.py +120 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_context.py +33 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_events.py +276 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_lifecycle.py +112 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_llm.py +455 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_policy_admin.py +48 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_client.py +138 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_gateway.py +183 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_listener_options.py +79 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_service.py +143 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_reset_receipts.py +97 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_contracts.py +298 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_evaluation.py +53 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_reader.py +382 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_response.py +122 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_service.py +880 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_visibility.py +115 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_checkpoint_lifecycle.py +7 -4
- hermes_plugin_qdrant_memory-0.5.0/tests/test_ci_gate.py +195 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_ci_infrastructure_retry.py +124 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_config_embedding.py +16 -2
- hermes_plugin_qdrant_memory-0.5.0/tests/test_dependency_inputs.py +195 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_dependency_security.py +42 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_explicit_dedupe.py +269 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_fastembed_compat.py +145 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_input_validation.py +31 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_local_embedding_provider.py +6 -3
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_manifest_contract.py +8 -1
- hermes_plugin_qdrant_memory-0.5.0/tests/test_model_smoke.py +154 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_native_owner.py +559 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_native_unadmitted.py +268 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_http.py +398 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_models.py +130 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_preflight.py +334 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_runner.py +377 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_workflow.py +71 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_pi_quality_driver.py +80 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_dependencies.py +34 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_metrics.py +224 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_mutations.py +152 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_ollama_setup.py +85 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_profiles.py +236 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_runner.py +211 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_readme_release_contract.py +136 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_remote_shutdown.py +151 -0
- hermes_plugin_qdrant_memory-0.5.0/tests/test_shared_recall.py +305 -0
- hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/dedupe.py +0 -34
- hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/extraction.py +0 -90
- hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/ownership.py +0 -48
- hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/standalone.py +0 -236
- hermes_plugin_qdrant_memory-0.3.0/tests/test_ci_gate.py +0 -62
- hermes_plugin_qdrant_memory-0.3.0/tests/test_explicit_dedupe.py +0 -80
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/LICENSE +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/MANIFEST.in +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/dependency_links.txt +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/entry_points.txt +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/top_level.txt +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/config_schema.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/inventory.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/managed_setup.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/migration.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/models.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/private_paths.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/progress.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/reset.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/retry.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/setup.cfg +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/conftest.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/local_model/test_acceptance.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_explicit_writes.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_managed_setup.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_public_api.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_standalone.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_backend_contracts.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_bot_scope.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_bounded_recovery.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_cli_output.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_deletion_ordering.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_discovery_cli.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_host_lifecycle.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_host_pins.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_inventory_export.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_live_metrics.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_local_embedding.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_local_model.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_maintenance.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_endpoints.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_progress.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_resume.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_superseded.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_profile_scope.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_provider.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_recovery_benchmark.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_recovery_evaluation.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_remote_qdrant.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_reset_inspection.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_reset_recovery.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_retention.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_review_regressions.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_session_provenance.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_setup_contract.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_shutdown_contract.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_store_runtime.py +0 -0
- {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_writer_ownership.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: hermes-plugin-qdrant-memory
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.5.0
|
|
4
4
|
Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
|
|
@@ -15,14 +15,27 @@ License-File: LICENSE
|
|
|
15
15
|
Requires-Dist: qdrant-client<2,>=1.15
|
|
16
16
|
Requires-Dist: httpx<1,>=0.28
|
|
17
17
|
Requires-Dist: portalocker<4,>=3.2
|
|
18
|
+
Requires-Dist: jsonschema<5,>=4.23
|
|
18
19
|
Provides-Extra: mcp
|
|
19
20
|
Requires-Dist: mcp<3,>=1.30; extra == "mcp"
|
|
21
|
+
Provides-Extra: remote
|
|
22
|
+
Requires-Dist: mcp<3,>=1.30; extra == "remote"
|
|
23
|
+
Requires-Dist: uvicorn<1,>=0.35; extra == "remote"
|
|
20
24
|
Provides-Extra: local
|
|
21
25
|
Requires-Dist: fastembed==0.9.0; extra == "local"
|
|
22
26
|
Dynamic: license-file
|
|
23
27
|
|
|
24
28
|
# Qdrant Memory for Hermes
|
|
25
29
|
|
|
30
|
+
Shared deployment hardening in this checkout is documented in the
|
|
31
|
+
[protected destination guide](docs/shared-memory/deployment-security.md) and
|
|
32
|
+
[versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
|
|
33
|
+
are included in Runtime 0.5.0. Remote access needs the `[remote]` extra.
|
|
34
|
+
|
|
35
|
+
## One Memory, Multiple Agents — opt-in shared owner
|
|
36
|
+
|
|
37
|
+
Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge. Multiple agents can share an explicitly authorized space while legacy records remain private. Hermes Native Provider and existing private defaults remain unchanged. See [setup, Hermes/DSH walkthrough and limits](docs/shared-memory/README.md), [architecture](docs/shared-memory/architecture.md), and [validation](docs/shared-memory/report.md). Runtime 0.5.0 adds opt-in Native Owner extraction, device grants and HTTPS MCP. See the [remote Owner guide](docs/shared-memory/remote-owner.md).
|
|
38
|
+
|
|
26
39
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml)
|
|
27
40
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml)
|
|
28
41
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml)
|
|
@@ -30,19 +43,22 @@ Dynamic: license-file
|
|
|
30
43
|
[](https://www.python.org/downloads/)
|
|
31
44
|
[](LICENSE)
|
|
32
45
|
|
|
33
|
-
> **Runtime 0.
|
|
34
|
-
>
|
|
46
|
+
> **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
|
|
47
|
+
> bridge for explicit shared memory. It keeps the optional offline CPU embedding,
|
|
48
|
+
> trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
|
|
35
49
|
> Explicit writes retain canonical-text deduplication without an LLM.
|
|
36
|
-
>
|
|
37
|
-
>
|
|
50
|
+
> This guide selects Runtime 0.5.0. Check its availability on
|
|
51
|
+
> [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) before installation.
|
|
52
|
+
> The generic MCP distribution and managed launcher select their own exact Runtime
|
|
53
|
+
> dependency and are released independently.
|
|
38
54
|
> The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
|
|
39
55
|
> does not upgrade it. One writer per destination remains required.
|
|
40
|
-
> See [release notes](docs/releases/0.
|
|
56
|
+
> See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
|
|
41
57
|
|
|
42
58
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
43
59
|
|
|
44
|
-
New in 0.
|
|
45
|
-
adds
|
|
60
|
+
New in 0.5.0: [shared memory for multiple agents](docs/shared-memory/README.md)
|
|
61
|
+
adds an opt-in authenticated local owner without changing private defaults.
|
|
46
62
|
|
|
47
63
|
Native long-term memory plugin for Hermes Agent, implemented as a `MemoryProvider`.
|
|
48
64
|
Hermes performs extraction
|
|
@@ -55,7 +71,7 @@ as a community-maintained plugin.
|
|
|
55
71
|
## How it works
|
|
56
72
|
|
|
57
73
|
For non-Hermes users, install in a private Python 3.11+
|
|
58
|
-
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.
|
|
74
|
+
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
|
|
59
75
|
for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
|
|
60
76
|
Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
|
|
61
77
|
MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
|
|
@@ -96,8 +112,7 @@ The plugin primarily provides Hermes Agent's durable memory integration. As an
|
|
|
96
112
|
additional capability, its shared backend can serve other agents through the
|
|
97
113
|
Runtime's `qdrant-memory --home PATH` JSON CLI and optional local stdio MCP
|
|
98
114
|
interface. Standalone use does not require Hermes. These interfaces support explicit scoped
|
|
99
|
-
memory operations and maintenance/migration. Automatic extraction and prefetch
|
|
100
|
-
remain Hermes lifecycle features. See [standalone setup](docs/standalone.md) for
|
|
115
|
+
memory operations and maintenance/migration. Automatic extraction and prefetch use the Hermes Native Owner or the opt-in Pi lifecycle adapter. See [standalone setup](docs/standalone.md) for
|
|
101
116
|
configuration and boundaries, and the agent-neutral
|
|
102
117
|
[qdrant-memory skill](https://github.com/cnkang/skills/tree/main/qdrant-memory)
|
|
103
118
|
for multi-agent installation and usage guidance.
|
|
@@ -131,7 +146,11 @@ to serve `qwen3-embedding:4b`.
|
|
|
131
146
|
|
|
132
147
|
Choose the **active profile's** home explicitly. Do not reuse another profile's data.
|
|
133
148
|
|
|
134
|
-
**
|
|
149
|
+
**Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
|
|
150
|
+
|
|
151
|
+
The Catalog selects its own fixed revision, which may be older than Runtime
|
|
152
|
+
0.5.0. To use the current release, including opt-in shared memory, follow the
|
|
153
|
+
recommended version-locked installation below.
|
|
135
154
|
|
|
136
155
|
```bash
|
|
137
156
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -148,36 +167,35 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
|
|
|
148
167
|
tools, requirements and known issues before it clones anything.
|
|
149
168
|
`hermes plugins enable` prepares the declared dependencies through Hermes PM.
|
|
150
169
|
|
|
151
|
-
**
|
|
170
|
+
**Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
|
|
152
171
|
|
|
153
|
-
This immutable source revision includes
|
|
154
|
-
|
|
172
|
+
This immutable source revision includes opt-in shared memory. It does not depend
|
|
173
|
+
on a PyPI release or a catalog update.
|
|
155
174
|
|
|
156
175
|
```bash
|
|
157
176
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
158
177
|
ollama pull qwen3-embedding:4b
|
|
159
178
|
# Start Ollama if it is not running. Keep its service available.
|
|
160
179
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
161
|
-
--ref
|
|
180
|
+
--ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
|
|
162
181
|
hermes plugins enable qdrant-memory
|
|
163
182
|
hermes memory setup
|
|
164
183
|
hermes config set memory.provider qdrant-memory
|
|
165
184
|
hermes qdrant-memory init
|
|
166
185
|
```
|
|
167
186
|
|
|
168
|
-
**Previous verified source: install Runtime 0.
|
|
187
|
+
**Previous verified source: install Runtime 0.3.0 through the Hermes CLI.**
|
|
169
188
|
|
|
170
|
-
This older immutable source revision
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
depend on a PyPI release or a catalog update.
|
|
189
|
+
This older immutable source revision includes optional CPU embedding and guided
|
|
190
|
+
setup, but it predates opt-in shared memory. For the current release use
|
|
191
|
+
Runtime 0.5.0 above. It does not depend on a PyPI release or a catalog update.
|
|
174
192
|
|
|
175
193
|
```bash
|
|
176
194
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
177
195
|
ollama pull qwen3-embedding:4b
|
|
178
196
|
# Start Ollama if it is not running. Keep its service available.
|
|
179
197
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
180
|
-
--ref
|
|
198
|
+
--ref 534562f1df43541dbf906d248bb11cd085b211ee # verified Runtime 0.3.0 source
|
|
181
199
|
hermes plugins enable qdrant-memory
|
|
182
200
|
hermes memory setup
|
|
183
201
|
hermes config set memory.provider qdrant-memory
|
|
@@ -194,7 +212,7 @@ environment. Omit `--ref` to track `main`, the development line.
|
|
|
194
212
|
**Historical release: clone a published tag manually.**
|
|
195
213
|
|
|
196
214
|
The v0.1.0 tag below predates the standalone interfaces and the explicit-write
|
|
197
|
-
fix. Use the pinned source above for Runtime 0.
|
|
215
|
+
fix. Use the pinned source above for Runtime 0.5.0.
|
|
198
216
|
|
|
199
217
|
```bash
|
|
200
218
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -1,28 +1,14 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: hermes-plugin-qdrant-memory
|
|
3
|
-
Version: 0.3.0
|
|
4
|
-
Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
|
|
5
|
-
License-Expression: MIT
|
|
6
|
-
Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
|
|
7
|
-
Project-URL: Repository, https://github.com/cnkang/hermes-plugin-qdrant-memory
|
|
8
|
-
Project-URL: Issues, https://github.com/cnkang/hermes-plugin-qdrant-memory/issues
|
|
9
|
-
Project-URL: Changelog, https://github.com/cnkang/hermes-plugin-qdrant-memory/blob/main/CHANGELOG.md
|
|
10
|
-
Project-URL: MCP, https://github.com/cnkang/qdrant-memory-mcp
|
|
11
|
-
Project-URL: Skill, https://github.com/cnkang/skills/tree/main/qdrant-memory
|
|
12
|
-
Requires-Python: >=3.11
|
|
13
|
-
Description-Content-Type: text/markdown
|
|
14
|
-
License-File: LICENSE
|
|
15
|
-
Requires-Dist: qdrant-client<2,>=1.15
|
|
16
|
-
Requires-Dist: httpx<1,>=0.28
|
|
17
|
-
Requires-Dist: portalocker<4,>=3.2
|
|
18
|
-
Provides-Extra: mcp
|
|
19
|
-
Requires-Dist: mcp<3,>=1.30; extra == "mcp"
|
|
20
|
-
Provides-Extra: local
|
|
21
|
-
Requires-Dist: fastembed==0.9.0; extra == "local"
|
|
22
|
-
Dynamic: license-file
|
|
23
|
-
|
|
24
1
|
# Qdrant Memory for Hermes
|
|
25
2
|
|
|
3
|
+
Shared deployment hardening in this checkout is documented in the
|
|
4
|
+
[protected destination guide](docs/shared-memory/deployment-security.md) and
|
|
5
|
+
[versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
|
|
6
|
+
are included in Runtime 0.5.0. Remote access needs the `[remote]` extra.
|
|
7
|
+
|
|
8
|
+
## One Memory, Multiple Agents — opt-in shared owner
|
|
9
|
+
|
|
10
|
+
Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge. Multiple agents can share an explicitly authorized space while legacy records remain private. Hermes Native Provider and existing private defaults remain unchanged. See [setup, Hermes/DSH walkthrough and limits](docs/shared-memory/README.md), [architecture](docs/shared-memory/architecture.md), and [validation](docs/shared-memory/report.md). Runtime 0.5.0 adds opt-in Native Owner extraction, device grants and HTTPS MCP. See the [remote Owner guide](docs/shared-memory/remote-owner.md).
|
|
11
|
+
|
|
26
12
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml)
|
|
27
13
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml)
|
|
28
14
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml)
|
|
@@ -30,19 +16,22 @@ Dynamic: license-file
|
|
|
30
16
|
[](https://www.python.org/downloads/)
|
|
31
17
|
[](LICENSE)
|
|
32
18
|
|
|
33
|
-
> **Runtime 0.
|
|
34
|
-
>
|
|
19
|
+
> **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
|
|
20
|
+
> bridge for explicit shared memory. It keeps the optional offline CPU embedding,
|
|
21
|
+
> trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
|
|
35
22
|
> Explicit writes retain canonical-text deduplication without an LLM.
|
|
36
|
-
>
|
|
37
|
-
>
|
|
23
|
+
> This guide selects Runtime 0.5.0. Check its availability on
|
|
24
|
+
> [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) before installation.
|
|
25
|
+
> The generic MCP distribution and managed launcher select their own exact Runtime
|
|
26
|
+
> dependency and are released independently.
|
|
38
27
|
> The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
|
|
39
28
|
> does not upgrade it. One writer per destination remains required.
|
|
40
|
-
> See [release notes](docs/releases/0.
|
|
29
|
+
> See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
|
|
41
30
|
|
|
42
31
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
43
32
|
|
|
44
|
-
New in 0.
|
|
45
|
-
adds
|
|
33
|
+
New in 0.5.0: [shared memory for multiple agents](docs/shared-memory/README.md)
|
|
34
|
+
adds an opt-in authenticated local owner without changing private defaults.
|
|
46
35
|
|
|
47
36
|
Native long-term memory plugin for Hermes Agent, implemented as a `MemoryProvider`.
|
|
48
37
|
Hermes performs extraction
|
|
@@ -55,7 +44,7 @@ as a community-maintained plugin.
|
|
|
55
44
|
## How it works
|
|
56
45
|
|
|
57
46
|
For non-Hermes users, install in a private Python 3.11+
|
|
58
|
-
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.
|
|
47
|
+
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
|
|
59
48
|
for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
|
|
60
49
|
Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
|
|
61
50
|
MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
|
|
@@ -96,8 +85,7 @@ The plugin primarily provides Hermes Agent's durable memory integration. As an
|
|
|
96
85
|
additional capability, its shared backend can serve other agents through the
|
|
97
86
|
Runtime's `qdrant-memory --home PATH` JSON CLI and optional local stdio MCP
|
|
98
87
|
interface. Standalone use does not require Hermes. These interfaces support explicit scoped
|
|
99
|
-
memory operations and maintenance/migration. Automatic extraction and prefetch
|
|
100
|
-
remain Hermes lifecycle features. See [standalone setup](docs/standalone.md) for
|
|
88
|
+
memory operations and maintenance/migration. Automatic extraction and prefetch use the Hermes Native Owner or the opt-in Pi lifecycle adapter. See [standalone setup](docs/standalone.md) for
|
|
101
89
|
configuration and boundaries, and the agent-neutral
|
|
102
90
|
[qdrant-memory skill](https://github.com/cnkang/skills/tree/main/qdrant-memory)
|
|
103
91
|
for multi-agent installation and usage guidance.
|
|
@@ -131,7 +119,11 @@ to serve `qwen3-embedding:4b`.
|
|
|
131
119
|
|
|
132
120
|
Choose the **active profile's** home explicitly. Do not reuse another profile's data.
|
|
133
121
|
|
|
134
|
-
**
|
|
122
|
+
**Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
|
|
123
|
+
|
|
124
|
+
The Catalog selects its own fixed revision, which may be older than Runtime
|
|
125
|
+
0.5.0. To use the current release, including opt-in shared memory, follow the
|
|
126
|
+
recommended version-locked installation below.
|
|
135
127
|
|
|
136
128
|
```bash
|
|
137
129
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -148,36 +140,35 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
|
|
|
148
140
|
tools, requirements and known issues before it clones anything.
|
|
149
141
|
`hermes plugins enable` prepares the declared dependencies through Hermes PM.
|
|
150
142
|
|
|
151
|
-
**
|
|
143
|
+
**Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
|
|
152
144
|
|
|
153
|
-
This immutable source revision includes
|
|
154
|
-
|
|
145
|
+
This immutable source revision includes opt-in shared memory. It does not depend
|
|
146
|
+
on a PyPI release or a catalog update.
|
|
155
147
|
|
|
156
148
|
```bash
|
|
157
149
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
158
150
|
ollama pull qwen3-embedding:4b
|
|
159
151
|
# Start Ollama if it is not running. Keep its service available.
|
|
160
152
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
161
|
-
--ref
|
|
153
|
+
--ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
|
|
162
154
|
hermes plugins enable qdrant-memory
|
|
163
155
|
hermes memory setup
|
|
164
156
|
hermes config set memory.provider qdrant-memory
|
|
165
157
|
hermes qdrant-memory init
|
|
166
158
|
```
|
|
167
159
|
|
|
168
|
-
**Previous verified source: install Runtime 0.
|
|
160
|
+
**Previous verified source: install Runtime 0.3.0 through the Hermes CLI.**
|
|
169
161
|
|
|
170
|
-
This older immutable source revision
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
depend on a PyPI release or a catalog update.
|
|
162
|
+
This older immutable source revision includes optional CPU embedding and guided
|
|
163
|
+
setup, but it predates opt-in shared memory. For the current release use
|
|
164
|
+
Runtime 0.5.0 above. It does not depend on a PyPI release or a catalog update.
|
|
174
165
|
|
|
175
166
|
```bash
|
|
176
167
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
177
168
|
ollama pull qwen3-embedding:4b
|
|
178
169
|
# Start Ollama if it is not running. Keep its service available.
|
|
179
170
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
180
|
-
--ref
|
|
171
|
+
--ref 534562f1df43541dbf906d248bb11cd085b211ee # verified Runtime 0.3.0 source
|
|
181
172
|
hermes plugins enable qdrant-memory
|
|
182
173
|
hermes memory setup
|
|
183
174
|
hermes config set memory.provider qdrant-memory
|
|
@@ -194,7 +185,7 @@ environment. Omit `--ref` to track `main`, the development line.
|
|
|
194
185
|
**Historical release: clone a published tag manually.**
|
|
195
186
|
|
|
196
187
|
The v0.1.0 tag below predates the standalone interfaces and the explicit-write
|
|
197
|
-
fix. Use the pinned source above for Runtime 0.
|
|
188
|
+
fix. Use the pinned source above for Runtime 0.5.0.
|
|
198
189
|
|
|
199
190
|
```bash
|
|
200
191
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
{hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/docs/local-embedding.md
RENAMED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Optional local CPU embedding and guided setup
|
|
2
2
|
|
|
3
|
-
These commands
|
|
3
|
+
These commands are available in Runtime 0.5.0. Published Runtime 0.2.2 and MCP
|
|
4
4
|
distribution 0.1.3 predate them. Those packages keep their existing
|
|
5
5
|
configuration workflow.
|
|
6
6
|
|
|
@@ -35,8 +35,11 @@ python -m pip install '.[mcp,local]'
|
|
|
35
35
|
|
|
36
36
|
For a published package, install the same extras with the release version:
|
|
37
37
|
|
|
38
|
+
Check [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) for
|
|
39
|
+
Runtime 0.5.0 availability before running this command.
|
|
40
|
+
|
|
38
41
|
```sh
|
|
39
|
-
python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.
|
|
42
|
+
python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.5.0'
|
|
40
43
|
```
|
|
41
44
|
|
|
42
45
|
Choose **one** setup command and replace the profile path with a new absolute
|
|
@@ -69,7 +72,7 @@ name, supply `--embedding-api-key-env VARIABLE_NAME`.
|
|
|
69
72
|
|
|
70
73
|
Use a different profile and `--agent-id` for each client. `--user-id` defaults to
|
|
71
74
|
`local-user`. Self-hosted/Cloud Qdrant storage continues to use the existing
|
|
72
|
-
[configuration workflow](configuration.md)
|
|
75
|
+
[configuration workflow](configuration.md). This setup command creates only a
|
|
73
76
|
new embedded destination. A remote embedding choice is distinct from remote
|
|
74
77
|
Qdrant storage.
|
|
75
78
|
|
|
@@ -102,7 +105,7 @@ Managed cache/profile paths must be canonical absolute paths without symlinks
|
|
|
102
105
|
or Windows reparse points, including intermediate directories.
|
|
103
106
|
|
|
104
107
|
Preparation requires network access and may take several minutes. Start MCP
|
|
105
|
-
after preparation and setup complete
|
|
108
|
+
after preparation and setup complete. Do not place the download inside a
|
|
106
109
|
30-second connection handshake. Normal provider startup verifies cached files
|
|
107
110
|
and performs no downloads. Prepared CPU inference works offline and does not
|
|
108
111
|
send memory/query text to an embedding service.
|
|
@@ -110,7 +113,7 @@ send memory/query text to an embedding service.
|
|
|
110
113
|
Downloads use a provisioning lock and a private staging directory. The complete
|
|
111
114
|
cache is published only after every file passes validation. Failed preparation
|
|
112
115
|
can be retried with the same command. A corrupt completed cache is rejected and
|
|
113
|
-
left untouched
|
|
116
|
+
left untouched. It is not silently replaced. Select a new cache directory for
|
|
114
117
|
explicit re-preparation, preserving the old files for diagnosis or recovery.
|
|
115
118
|
|
|
116
119
|
## Safety, limits and recovery
|
|
@@ -127,7 +130,7 @@ explicit re-preparation, preserving the old files for diagnosis or recovery.
|
|
|
127
130
|
- Choosing CPU for a collection created with Ollama or another model is not a
|
|
128
131
|
migration. Existing incompatible collections fail compatibility checks.
|
|
129
132
|
- `LocalModelNotPreparedError`: run explicit preparation with the correct cache.
|
|
130
|
-
- `LocalModelIntegrityError`: do not bypass checks
|
|
133
|
+
- `LocalModelIntegrityError`: do not bypass checks. Explicitly prepare a new cache.
|
|
131
134
|
- `LocalEmbeddingUnavailableError`: install the reviewed `local` extra.
|
|
132
135
|
- `ManagedProfileConflictError`: retain the existing profile and choose a new
|
|
133
136
|
directory, or use the existing advanced configuration/maintenance workflow.
|
|
@@ -141,7 +144,7 @@ extraction, new network listener or cloud credential custody is introduced.
|
|
|
141
144
|
Real local CPU inference and offline official-MCP CRUD/restart tests are separate
|
|
142
145
|
from package installation and real WorkBuddy GUI acceptance. The optional local
|
|
143
146
|
embedding workflow tests native Linux x64, Windows x64 and macOS Apple Silicon
|
|
144
|
-
with Python 3.11.
|
|
147
|
+
with Python 3.11. MacOS Intel is best-effort compatibility and is not a release
|
|
145
148
|
gate or a formally supported CPU platform. A successful dependency resolution
|
|
146
149
|
alone is not a platform support claim. ARM64 variants outside macOS require
|
|
147
150
|
separate acceptance.
|
|
@@ -1,5 +1,41 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: hermes-plugin-qdrant-memory
|
|
3
|
+
Version: 0.5.0
|
|
4
|
+
Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
|
|
5
|
+
License-Expression: MIT
|
|
6
|
+
Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
|
|
7
|
+
Project-URL: Repository, https://github.com/cnkang/hermes-plugin-qdrant-memory
|
|
8
|
+
Project-URL: Issues, https://github.com/cnkang/hermes-plugin-qdrant-memory/issues
|
|
9
|
+
Project-URL: Changelog, https://github.com/cnkang/hermes-plugin-qdrant-memory/blob/main/CHANGELOG.md
|
|
10
|
+
Project-URL: MCP, https://github.com/cnkang/qdrant-memory-mcp
|
|
11
|
+
Project-URL: Skill, https://github.com/cnkang/skills/tree/main/qdrant-memory
|
|
12
|
+
Requires-Python: >=3.11
|
|
13
|
+
Description-Content-Type: text/markdown
|
|
14
|
+
License-File: LICENSE
|
|
15
|
+
Requires-Dist: qdrant-client<2,>=1.15
|
|
16
|
+
Requires-Dist: httpx<1,>=0.28
|
|
17
|
+
Requires-Dist: portalocker<4,>=3.2
|
|
18
|
+
Requires-Dist: jsonschema<5,>=4.23
|
|
19
|
+
Provides-Extra: mcp
|
|
20
|
+
Requires-Dist: mcp<3,>=1.30; extra == "mcp"
|
|
21
|
+
Provides-Extra: remote
|
|
22
|
+
Requires-Dist: mcp<3,>=1.30; extra == "remote"
|
|
23
|
+
Requires-Dist: uvicorn<1,>=0.35; extra == "remote"
|
|
24
|
+
Provides-Extra: local
|
|
25
|
+
Requires-Dist: fastembed==0.9.0; extra == "local"
|
|
26
|
+
Dynamic: license-file
|
|
27
|
+
|
|
1
28
|
# Qdrant Memory for Hermes
|
|
2
29
|
|
|
30
|
+
Shared deployment hardening in this checkout is documented in the
|
|
31
|
+
[protected destination guide](docs/shared-memory/deployment-security.md) and
|
|
32
|
+
[versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
|
|
33
|
+
are included in Runtime 0.5.0. Remote access needs the `[remote]` extra.
|
|
34
|
+
|
|
35
|
+
## One Memory, Multiple Agents — opt-in shared owner
|
|
36
|
+
|
|
37
|
+
Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge. Multiple agents can share an explicitly authorized space while legacy records remain private. Hermes Native Provider and existing private defaults remain unchanged. See [setup, Hermes/DSH walkthrough and limits](docs/shared-memory/README.md), [architecture](docs/shared-memory/architecture.md), and [validation](docs/shared-memory/report.md). Runtime 0.5.0 adds opt-in Native Owner extraction, device grants and HTTPS MCP. See the [remote Owner guide](docs/shared-memory/remote-owner.md).
|
|
38
|
+
|
|
3
39
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml)
|
|
4
40
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml)
|
|
5
41
|
[](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml)
|
|
@@ -7,19 +43,22 @@
|
|
|
7
43
|
[](https://www.python.org/downloads/)
|
|
8
44
|
[](LICENSE)
|
|
9
45
|
|
|
10
|
-
> **Runtime 0.
|
|
11
|
-
>
|
|
46
|
+
> **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
|
|
47
|
+
> bridge for explicit shared memory. It keeps the optional offline CPU embedding,
|
|
48
|
+
> trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
|
|
12
49
|
> Explicit writes retain canonical-text deduplication without an LLM.
|
|
13
|
-
>
|
|
14
|
-
>
|
|
50
|
+
> This guide selects Runtime 0.5.0. Check its availability on
|
|
51
|
+
> [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) before installation.
|
|
52
|
+
> The generic MCP distribution and managed launcher select their own exact Runtime
|
|
53
|
+
> dependency and are released independently.
|
|
15
54
|
> The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
|
|
16
55
|
> does not upgrade it. One writer per destination remains required.
|
|
17
|
-
> See [release notes](docs/releases/0.
|
|
56
|
+
> See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
|
|
18
57
|
|
|
19
58
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
20
59
|
|
|
21
|
-
New in 0.
|
|
22
|
-
adds
|
|
60
|
+
New in 0.5.0: [shared memory for multiple agents](docs/shared-memory/README.md)
|
|
61
|
+
adds an opt-in authenticated local owner without changing private defaults.
|
|
23
62
|
|
|
24
63
|
Native long-term memory plugin for Hermes Agent, implemented as a `MemoryProvider`.
|
|
25
64
|
Hermes performs extraction
|
|
@@ -32,7 +71,7 @@ as a community-maintained plugin.
|
|
|
32
71
|
## How it works
|
|
33
72
|
|
|
34
73
|
For non-Hermes users, install in a private Python 3.11+
|
|
35
|
-
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.
|
|
74
|
+
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
|
|
36
75
|
for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
|
|
37
76
|
Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
|
|
38
77
|
MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
|
|
@@ -73,8 +112,7 @@ The plugin primarily provides Hermes Agent's durable memory integration. As an
|
|
|
73
112
|
additional capability, its shared backend can serve other agents through the
|
|
74
113
|
Runtime's `qdrant-memory --home PATH` JSON CLI and optional local stdio MCP
|
|
75
114
|
interface. Standalone use does not require Hermes. These interfaces support explicit scoped
|
|
76
|
-
memory operations and maintenance/migration. Automatic extraction and prefetch
|
|
77
|
-
remain Hermes lifecycle features. See [standalone setup](docs/standalone.md) for
|
|
115
|
+
memory operations and maintenance/migration. Automatic extraction and prefetch use the Hermes Native Owner or the opt-in Pi lifecycle adapter. See [standalone setup](docs/standalone.md) for
|
|
78
116
|
configuration and boundaries, and the agent-neutral
|
|
79
117
|
[qdrant-memory skill](https://github.com/cnkang/skills/tree/main/qdrant-memory)
|
|
80
118
|
for multi-agent installation and usage guidance.
|
|
@@ -108,7 +146,11 @@ to serve `qwen3-embedding:4b`.
|
|
|
108
146
|
|
|
109
147
|
Choose the **active profile's** home explicitly. Do not reuse another profile's data.
|
|
110
148
|
|
|
111
|
-
**
|
|
149
|
+
**Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
|
|
150
|
+
|
|
151
|
+
The Catalog selects its own fixed revision, which may be older than Runtime
|
|
152
|
+
0.5.0. To use the current release, including opt-in shared memory, follow the
|
|
153
|
+
recommended version-locked installation below.
|
|
112
154
|
|
|
113
155
|
```bash
|
|
114
156
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -125,36 +167,35 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
|
|
|
125
167
|
tools, requirements and known issues before it clones anything.
|
|
126
168
|
`hermes plugins enable` prepares the declared dependencies through Hermes PM.
|
|
127
169
|
|
|
128
|
-
**
|
|
170
|
+
**Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
|
|
129
171
|
|
|
130
|
-
This immutable source revision includes
|
|
131
|
-
|
|
172
|
+
This immutable source revision includes opt-in shared memory. It does not depend
|
|
173
|
+
on a PyPI release or a catalog update.
|
|
132
174
|
|
|
133
175
|
```bash
|
|
134
176
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
135
177
|
ollama pull qwen3-embedding:4b
|
|
136
178
|
# Start Ollama if it is not running. Keep its service available.
|
|
137
179
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
138
|
-
--ref
|
|
180
|
+
--ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
|
|
139
181
|
hermes plugins enable qdrant-memory
|
|
140
182
|
hermes memory setup
|
|
141
183
|
hermes config set memory.provider qdrant-memory
|
|
142
184
|
hermes qdrant-memory init
|
|
143
185
|
```
|
|
144
186
|
|
|
145
|
-
**Previous verified source: install Runtime 0.
|
|
187
|
+
**Previous verified source: install Runtime 0.3.0 through the Hermes CLI.**
|
|
146
188
|
|
|
147
|
-
This older immutable source revision
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
depend on a PyPI release or a catalog update.
|
|
189
|
+
This older immutable source revision includes optional CPU embedding and guided
|
|
190
|
+
setup, but it predates opt-in shared memory. For the current release use
|
|
191
|
+
Runtime 0.5.0 above. It does not depend on a PyPI release or a catalog update.
|
|
151
192
|
|
|
152
193
|
```bash
|
|
153
194
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
154
195
|
ollama pull qwen3-embedding:4b
|
|
155
196
|
# Start Ollama if it is not running. Keep its service available.
|
|
156
197
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
157
|
-
--ref
|
|
198
|
+
--ref 534562f1df43541dbf906d248bb11cd085b211ee # verified Runtime 0.3.0 source
|
|
158
199
|
hermes plugins enable qdrant-memory
|
|
159
200
|
hermes memory setup
|
|
160
201
|
hermes config set memory.provider qdrant-memory
|
|
@@ -171,7 +212,7 @@ environment. Omit `--ref` to track `main`, the development line.
|
|
|
171
212
|
**Historical release: clone a published tag manually.**
|
|
172
213
|
|
|
173
214
|
The v0.1.0 tag below predates the standalone interfaces and the explicit-write
|
|
174
|
-
fix. Use the pinned source above for Runtime 0.
|
|
215
|
+
fix. Use the pinned source above for Runtime 0.5.0.
|
|
175
216
|
|
|
176
217
|
```bash
|
|
177
218
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -26,15 +26,30 @@ qdrant_memory/managed_setup.py
|
|
|
26
26
|
qdrant_memory/mcp_server.py
|
|
27
27
|
qdrant_memory/migration.py
|
|
28
28
|
qdrant_memory/models.py
|
|
29
|
+
qdrant_memory/native_owner.py
|
|
30
|
+
qdrant_memory/owner_lifecycle.py
|
|
31
|
+
qdrant_memory/owner_llm.py
|
|
29
32
|
qdrant_memory/ownership.py
|
|
30
33
|
qdrant_memory/plugin.yaml
|
|
34
|
+
qdrant_memory/policy_admin.py
|
|
31
35
|
qdrant_memory/private_paths.py
|
|
32
36
|
qdrant_memory/progress.py
|
|
33
37
|
qdrant_memory/provider.py
|
|
34
38
|
qdrant_memory/qdrant_store.py
|
|
39
|
+
qdrant_memory/quality_metrics.py
|
|
40
|
+
qdrant_memory/remote_client.py
|
|
41
|
+
qdrant_memory/remote_gateway.py
|
|
42
|
+
qdrant_memory/remote_protocol.py
|
|
35
43
|
qdrant_memory/reset.py
|
|
36
44
|
qdrant_memory/retry.py
|
|
37
45
|
qdrant_memory/runtime.py
|
|
46
|
+
qdrant_memory/shared_client.py
|
|
47
|
+
qdrant_memory/shared_protocol.py
|
|
48
|
+
qdrant_memory/shared_reader.py
|
|
49
|
+
qdrant_memory/shared_recall.py
|
|
50
|
+
qdrant_memory/shared_security.py
|
|
51
|
+
qdrant_memory/shared_service.py
|
|
52
|
+
qdrant_memory/shared_state.py
|
|
38
53
|
qdrant_memory/standalone.py
|
|
39
54
|
qdrant_memory/tools.py
|
|
40
55
|
qdrant_memory/version.py
|
|
@@ -47,11 +62,15 @@ tests/test_bot_scope.py
|
|
|
47
62
|
tests/test_bounded_recovery.py
|
|
48
63
|
tests/test_checkpoint_lifecycle.py
|
|
49
64
|
tests/test_ci_gate.py
|
|
65
|
+
tests/test_ci_infrastructure_retry.py
|
|
50
66
|
tests/test_cli_output.py
|
|
51
67
|
tests/test_config_embedding.py
|
|
52
68
|
tests/test_deletion_ordering.py
|
|
69
|
+
tests/test_dependency_inputs.py
|
|
70
|
+
tests/test_dependency_security.py
|
|
53
71
|
tests/test_discovery_cli.py
|
|
54
72
|
tests/test_explicit_dedupe.py
|
|
73
|
+
tests/test_fastembed_compat.py
|
|
55
74
|
tests/test_host_lifecycle.py
|
|
56
75
|
tests/test_host_pins.py
|
|
57
76
|
tests/test_input_validation.py
|
|
@@ -67,23 +86,66 @@ tests/test_migration_endpoints.py
|
|
|
67
86
|
tests/test_migration_progress.py
|
|
68
87
|
tests/test_migration_resume.py
|
|
69
88
|
tests/test_migration_superseded.py
|
|
89
|
+
tests/test_model_smoke.py
|
|
90
|
+
tests/test_native_owner.py
|
|
91
|
+
tests/test_native_unadmitted.py
|
|
92
|
+
tests/test_openrouter_http.py
|
|
93
|
+
tests/test_openrouter_models.py
|
|
94
|
+
tests/test_openrouter_preflight.py
|
|
95
|
+
tests/test_openrouter_runner.py
|
|
96
|
+
tests/test_openrouter_workflow.py
|
|
97
|
+
tests/test_pi_quality_driver.py
|
|
70
98
|
tests/test_profile_scope.py
|
|
71
99
|
tests/test_provider.py
|
|
100
|
+
tests/test_quality_dependencies.py
|
|
101
|
+
tests/test_quality_metrics.py
|
|
102
|
+
tests/test_quality_mutations.py
|
|
103
|
+
tests/test_quality_ollama_setup.py
|
|
104
|
+
tests/test_quality_profiles.py
|
|
105
|
+
tests/test_quality_runner.py
|
|
106
|
+
tests/test_readme_release_contract.py
|
|
72
107
|
tests/test_recovery_benchmark.py
|
|
73
108
|
tests/test_recovery_evaluation.py
|
|
74
109
|
tests/test_remote_qdrant.py
|
|
110
|
+
tests/test_remote_shutdown.py
|
|
75
111
|
tests/test_reset_inspection.py
|
|
76
112
|
tests/test_reset_recovery.py
|
|
77
113
|
tests/test_retention.py
|
|
78
114
|
tests/test_review_regressions.py
|
|
79
115
|
tests/test_session_provenance.py
|
|
80
116
|
tests/test_setup_contract.py
|
|
117
|
+
tests/test_shared_recall.py
|
|
81
118
|
tests/test_shutdown_contract.py
|
|
82
119
|
tests/test_store_runtime.py
|
|
83
120
|
tests/test_writer_ownership.py
|
|
84
121
|
tests/local_model/test_acceptance.py
|
|
122
|
+
tests/remote/fixture.py
|
|
123
|
+
tests/security/__init__.py
|
|
124
|
+
tests/security/test_cloud_owner.py
|
|
125
|
+
tests/security/test_cloud_owner_cleanup.py
|
|
126
|
+
tests/security/test_device_server.py
|
|
127
|
+
tests/security/test_shared_security.py
|
|
128
|
+
tests/security/test_shared_security_live.py
|
|
85
129
|
tests/standalone/__init__.py
|
|
130
|
+
tests/standalone/test_admission_control.py
|
|
131
|
+
tests/standalone/test_device_grants.py
|
|
86
132
|
tests/standalone/test_explicit_writes.py
|
|
87
133
|
tests/standalone/test_managed_setup.py
|
|
134
|
+
tests/standalone/test_owner_context.py
|
|
135
|
+
tests/standalone/test_owner_events.py
|
|
136
|
+
tests/standalone/test_owner_lifecycle.py
|
|
137
|
+
tests/standalone/test_owner_llm.py
|
|
138
|
+
tests/standalone/test_policy_admin.py
|
|
88
139
|
tests/standalone/test_public_api.py
|
|
140
|
+
tests/standalone/test_remote_client.py
|
|
141
|
+
tests/standalone/test_remote_gateway.py
|
|
142
|
+
tests/standalone/test_remote_listener_options.py
|
|
143
|
+
tests/standalone/test_remote_service.py
|
|
144
|
+
tests/standalone/test_reset_receipts.py
|
|
145
|
+
tests/standalone/test_shared_contracts.py
|
|
146
|
+
tests/standalone/test_shared_evaluation.py
|
|
147
|
+
tests/standalone/test_shared_reader.py
|
|
148
|
+
tests/standalone/test_shared_response.py
|
|
149
|
+
tests/standalone/test_shared_service.py
|
|
150
|
+
tests/standalone/test_shared_visibility.py
|
|
89
151
|
tests/standalone/test_standalone.py
|