hermes-plugin-qdrant-memory 0.5.0__tar.gz → 0.5.2__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.5.0/hermes_plugin_qdrant_memory.egg-info → hermes_plugin_qdrant_memory-0.5.2}/PKG-INFO +95 -18
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/README.md +94 -17
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/docs/local-embedding.md +3 -3
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2/hermes_plugin_qdrant_memory.egg-info}/PKG-INFO +95 -18
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/SOURCES.txt +7 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/pyproject.toml +1 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/cli.py +33 -2
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/config.py +4 -1
- hermes_plugin_qdrant_memory-0.5.2/qdrant_memory/event_quarantine.py +91 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/extraction.py +1 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/ledger.py +34 -3
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/owner_lifecycle.py +7 -2
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/owner_llm.py +17 -2
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/plugin.yaml +1 -1
- hermes_plugin_qdrant_memory-0.5.2/qdrant_memory/remote_client.py +534 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/remote_gateway.py +25 -4
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/runtime.py +21 -3
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_security.py +26 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_state.py +1 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/standalone.py +9 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/version.py +1 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/requirements-local.txt +71 -71
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/requirements.txt +3 -3
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/scripts/demo.sh +1 -1
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_shared_security.py +95 -0
- hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_event_quarantine.py +184 -0
- hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_event_quarantine_security.py +250 -0
- hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_owner_diagnostics.py +77 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_client.py +4 -1
- hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_remote_listener.py +53 -0
- hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_remote_retry_contract.py +650 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_readme_release_contract.py +2 -2
- hermes_plugin_qdrant_memory-0.5.2/tests/test_restart_boundary.py +109 -0
- hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_client.py +0 -180
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/LICENSE +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/MANIFEST.in +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/dependency_links.txt +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/entry_points.txt +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/requires.txt +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/top_level.txt +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/config_schema.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/dedupe.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/embedding.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/inventory.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/local_embedding.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/local_model.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/managed_setup.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/mcp_server.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/migration.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/models.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/native_owner.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/ownership.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/policy_admin.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/private_paths.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/progress.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/provider.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/qdrant_store.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/quality_metrics.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/remote_protocol.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/reset.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/retry.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_client.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_protocol.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_reader.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_recall.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_service.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/tools.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/setup.cfg +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/conftest.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/helpers.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/local_model/test_acceptance.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/remote/fixture.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_cloud_owner.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_cloud_owner_cleanup.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_device_server.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_shared_security_live.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/__init__.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_admission_control.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_device_grants.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_explicit_writes.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_managed_setup.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_context.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_events.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_lifecycle.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_llm.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_policy_admin.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_public_api.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_gateway.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_listener_options.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_service.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_reset_receipts.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_contracts.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_evaluation.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_reader.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_response.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_service.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_visibility.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_standalone.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_backend_contracts.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_bot_scope.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_bounded_recovery.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_checkpoint_lifecycle.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_ci_gate.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_ci_infrastructure_retry.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_cli_output.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_config_embedding.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_deletion_ordering.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_dependency_inputs.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_dependency_security.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_discovery_cli.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_explicit_dedupe.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_fastembed_compat.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_host_lifecycle.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_host_pins.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_input_validation.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_inventory_export.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_live_metrics.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_local_embedding.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_local_embedding_provider.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_local_model.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_maintenance.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_manifest_contract.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_endpoints.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_progress.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_resume.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_superseded.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_model_smoke.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_native_owner.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_native_unadmitted.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_http.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_models.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_preflight.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_runner.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_workflow.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_pi_quality_driver.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_profile_scope.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_provider.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_dependencies.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_metrics.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_mutations.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_ollama_setup.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_profiles.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_runner.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_recovery_benchmark.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_recovery_evaluation.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_remote_qdrant.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_remote_shutdown.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_reset_inspection.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_reset_recovery.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_retention.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_review_regressions.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_session_provenance.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_setup_contract.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_shared_recall.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_shutdown_contract.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_store_runtime.py +0 -0
- {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/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.5.
|
|
3
|
+
Version: 0.5.2
|
|
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
|
|
@@ -27,10 +27,18 @@ Dynamic: license-file
|
|
|
27
27
|
|
|
28
28
|
# Qdrant Memory for Hermes
|
|
29
29
|
|
|
30
|
+
**One Memory. Multiple Agents.**
|
|
31
|
+
|
|
32
|
+
Durable, portable, and permission-aware memory for AI agents.
|
|
33
|
+
|
|
34
|
+
Share persistent memory across AI harnesses, sessions, and devices through one
|
|
35
|
+
Qdrant-backed Runtime. Integrate using native providers, MCP, CLI, or Agent
|
|
36
|
+
Skills—with explicit access control, conflict-safe updates, and crash recovery.
|
|
37
|
+
|
|
30
38
|
Shared deployment hardening in this checkout is documented in the
|
|
31
39
|
[protected destination guide](docs/shared-memory/deployment-security.md) and
|
|
32
40
|
[versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
|
|
33
|
-
are included in Runtime 0.5.
|
|
41
|
+
are included in Runtime 0.5.2. Remote access needs the `[remote]` extra.
|
|
34
42
|
|
|
35
43
|
## One Memory, Multiple Agents — opt-in shared owner
|
|
36
44
|
|
|
@@ -43,17 +51,19 @@ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge.
|
|
|
43
51
|
[](https://www.python.org/downloads/)
|
|
44
52
|
[](LICENSE)
|
|
45
53
|
|
|
46
|
-
> **Runtime 0.5.
|
|
54
|
+
> **Runtime 0.5.2** keeps the opt-in authenticated local shared owner and the stdio
|
|
47
55
|
> bridge for explicit shared memory. It keeps the optional offline CPU embedding,
|
|
48
56
|
> trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
|
|
49
57
|
> Explicit writes retain canonical-text deduplication without an LLM.
|
|
50
|
-
> This
|
|
51
|
-
>
|
|
58
|
+
> This patch makes a restart-interrupted write replayable with the same request
|
|
59
|
+
> identifier. It changes no schema and no collection identity.
|
|
60
|
+
> This guide selects Runtime 0.5.2. Check its availability on
|
|
61
|
+
> [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) before installation.
|
|
52
62
|
> The generic MCP distribution and managed launcher select their own exact Runtime
|
|
53
63
|
> dependency and are released independently.
|
|
54
64
|
> The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
|
|
55
65
|
> does not upgrade it. One writer per destination remains required.
|
|
56
|
-
> See [release notes](docs/releases/0.5.
|
|
66
|
+
> See [release notes](docs/releases/0.5.2.md) and [validation](docs/validation.md).
|
|
57
67
|
|
|
58
68
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
59
69
|
|
|
@@ -71,7 +81,7 @@ as a community-maintained plugin.
|
|
|
71
81
|
## How it works
|
|
72
82
|
|
|
73
83
|
For non-Hermes users, install in a private Python 3.11+
|
|
74
|
-
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.
|
|
84
|
+
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.2'` (omit `[mcp]`
|
|
75
85
|
for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
|
|
76
86
|
Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
|
|
77
87
|
MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
|
|
@@ -82,14 +92,27 @@ an authorized upgrade, verify the same profile, collection and embedding pipelin
|
|
|
82
92
|
|
|
83
93
|
```mermaid
|
|
84
94
|
flowchart LR
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
95
|
+
subgraph Private["Private standalone path"]
|
|
96
|
+
turn["Hermes turn"] --> admit["Provider callback"]
|
|
97
|
+
admit --> ledger[("SQLite ledger<br/>durable admission")]
|
|
98
|
+
ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
|
|
99
|
+
extract --> store[("Qdrant<br/>dense vectors + payloads")]
|
|
100
|
+
ask["Recall / search"] --> search["Scoped dense search"]
|
|
101
|
+
search --> store
|
|
102
|
+
end
|
|
103
|
+
subgraph Shared["Shared owner path (opt-in)"]
|
|
104
|
+
agent["Agent A / B"] --> owner["Shared Owner<br/>auth + scope"]
|
|
105
|
+
owner --> lease["WriterLease<br/>(current profile only)"]
|
|
106
|
+
lease --> store2[("Qdrant<br/>shared space")]
|
|
107
|
+
owner --> ledger2[("SQLite ledger")]
|
|
108
|
+
end
|
|
109
|
+
store -.migration/portability.-> store2
|
|
91
110
|
```
|
|
92
111
|
|
|
112
|
+
`WriterLease` coordinates only the current profile's writes. It does not prevent
|
|
113
|
+
other profiles or devices from writing to the same destination. "One writer per
|
|
114
|
+
destination" is an operational constraint, not an automatic cross-device lock.
|
|
115
|
+
|
|
93
116
|
## Why this plugin
|
|
94
117
|
|
|
95
118
|
- Durable, private memory for Hermes Agent: conversations become searchable
|
|
@@ -136,6 +159,19 @@ cleans up the demo scope. All steps
|
|
|
136
159
|
run in embedded mode. `scripts/demo.sh` reproduces the same walkthrough with
|
|
137
160
|
the pinned release.
|
|
138
161
|
|
|
162
|
+
## Choose your setup
|
|
163
|
+
|
|
164
|
+
| Use case | Recommended entry | Notes |
|
|
165
|
+
|---|---|---|
|
|
166
|
+
| Hermes native automatic memory | Native MemoryProvider | Automatic extraction and recall inside Hermes |
|
|
167
|
+
| Single agent, standalone MCP | Standalone MCP (`qdrant-memory-mcp`) | Explicit tools only, no auto-extraction |
|
|
168
|
+
| Multiple agents sharing memory | Authenticated Shared Owner | Opt-in. One writer per destination |
|
|
169
|
+
| Remote / multi-device access | HTTPS MCP + Owner | TLS, auth and network protection required |
|
|
170
|
+
| WorkBuddy / DSH | Host integration guides | Reuse the same Runtime |
|
|
171
|
+
| Migrate Mem0 data | Migration CLI | Source IDs, resumable manifest, verification |
|
|
172
|
+
|
|
173
|
+
See [standalone setup](docs/standalone.md), [shared memory](docs/shared-memory/README.md), and [cross-harness architecture](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md).
|
|
174
|
+
|
|
139
175
|
## Install
|
|
140
176
|
|
|
141
177
|
Requirements: Python 3.11+, a compatible Hermes installation, and a reachable
|
|
@@ -149,7 +185,7 @@ Choose the **active profile's** home explicitly. Do not reuse another profile's
|
|
|
149
185
|
**Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
|
|
150
186
|
|
|
151
187
|
The Catalog selects its own fixed revision, which may be older than Runtime
|
|
152
|
-
0.5.
|
|
188
|
+
0.5.2. To use the current release, including opt-in shared memory, follow the
|
|
153
189
|
recommended version-locked installation below.
|
|
154
190
|
|
|
155
191
|
```bash
|
|
@@ -167,7 +203,7 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
|
|
|
167
203
|
tools, requirements and known issues before it clones anything.
|
|
168
204
|
`hermes plugins enable` prepares the declared dependencies through Hermes PM.
|
|
169
205
|
|
|
170
|
-
**Recommended: install the version-locked Runtime 0.5.
|
|
206
|
+
**Recommended: install the version-locked Runtime 0.5.2 source through the Hermes CLI.**
|
|
171
207
|
|
|
172
208
|
This immutable source revision includes opt-in shared memory. It does not depend
|
|
173
209
|
on a PyPI release or a catalog update.
|
|
@@ -177,7 +213,7 @@ export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
|
177
213
|
ollama pull qwen3-embedding:4b
|
|
178
214
|
# Start Ollama if it is not running. Keep its service available.
|
|
179
215
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
180
|
-
--ref
|
|
216
|
+
--ref 604793341226e45f04500cd1d53fd668ddf89d63 # Runtime 0.5.2 release
|
|
181
217
|
hermes plugins enable qdrant-memory
|
|
182
218
|
hermes memory setup
|
|
183
219
|
hermes config set memory.provider qdrant-memory
|
|
@@ -188,7 +224,7 @@ hermes qdrant-memory init
|
|
|
188
224
|
|
|
189
225
|
This older immutable source revision includes optional CPU embedding and guided
|
|
190
226
|
setup, but it predates opt-in shared memory. For the current release use
|
|
191
|
-
Runtime 0.5.
|
|
227
|
+
Runtime 0.5.2 above. It does not depend on a PyPI release or a catalog update.
|
|
192
228
|
|
|
193
229
|
```bash
|
|
194
230
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -212,7 +248,7 @@ environment. Omit `--ref` to track `main`, the development line.
|
|
|
212
248
|
**Historical release: clone a published tag manually.**
|
|
213
249
|
|
|
214
250
|
The v0.1.0 tag below predates the standalone interfaces and the explicit-write
|
|
215
|
-
fix. Use the pinned source above for Runtime 0.5.
|
|
251
|
+
fix. Use the pinned source above for Runtime 0.5.2.
|
|
216
252
|
|
|
217
253
|
```bash
|
|
218
254
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -492,6 +528,20 @@ and non-primary-agent turns. Treat recalled content as untrusted data. See
|
|
|
492
528
|
[security](docs/security.md), [operating procedures](docs/operations.md),
|
|
493
529
|
[troubleshooting](docs/troubleshooting.md) and [architecture](docs/architecture.md).
|
|
494
530
|
|
|
531
|
+
## Capabilities and limitations
|
|
532
|
+
|
|
533
|
+
| Area | Status | Notes |
|
|
534
|
+
|---|---|---|
|
|
535
|
+
| Private memory (standalone) | Supported | Embedded / server / Cloud Qdrant |
|
|
536
|
+
| Automatic extraction (Hermes) | Supported | Trusted `ctx.llm` facade |
|
|
537
|
+
| Automatic recall (Hermes) | Supported | Scoped dense search |
|
|
538
|
+
| Shared memory (Shared Owner) | Opt-in | One writer per destination (operational constraint, not cross-device lock). Not the default |
|
|
539
|
+
| Automatic shared extraction | Opt-in | Native Owner and opt-in Pi lifecycle adapter |
|
|
540
|
+
| MCP auto-extraction | Not supported | Explicit tools only |
|
|
541
|
+
| Hybrid search / reranking | Not supported | Dense retrieval only (v0.1) |
|
|
542
|
+
| Multi-writer Server/Cloud | Not supported | One authoritative writer |
|
|
543
|
+
| Web UI | Not supported | CLI and tools only |
|
|
544
|
+
|
|
495
545
|
## Compatibility and scope
|
|
496
546
|
|
|
497
547
|
Version 0.1 implements dense retrieval. Hybrid sparse vectors, RRF/DBSF, reranking
|
|
@@ -556,6 +606,33 @@ for a separate synthetic replay and retained-storage measurement.
|
|
|
556
606
|
CI runs tests, SonarCloud quality gates and Snyk dependency/code scans.
|
|
557
607
|
See [CI service setup](docs/ci.md) and [validation evidence](docs/validation.md).
|
|
558
608
|
|
|
609
|
+
## Documentation
|
|
610
|
+
|
|
611
|
+
- [Getting started / standalone](docs/standalone.md)
|
|
612
|
+
- [Architecture](docs/architecture.md)
|
|
613
|
+
- [Configuration](docs/configuration.md)
|
|
614
|
+
- [Cross-harness sharing (MCP repo)](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md)
|
|
615
|
+
- [Shared memory](docs/shared-memory/README.md)
|
|
616
|
+
- [Security](docs/security.md)
|
|
617
|
+
- [Operations](docs/operations.md)
|
|
618
|
+
- [Migration from Mem0](docs/migration-from-mem0.md)
|
|
619
|
+
- [Backup and portability](docs/portability.md)
|
|
620
|
+
- [Validation and evidence](docs/validation.md)
|
|
621
|
+
- [Development](docs/development.md)
|
|
622
|
+
- [CI](docs/ci.md)
|
|
623
|
+
|
|
624
|
+
## Validation and evidence
|
|
625
|
+
|
|
626
|
+
Real evidence, not badges:
|
|
627
|
+
|
|
628
|
+
- Hermes native lifecycle tests: [validation](docs/validation.md)
|
|
629
|
+
- Cross-harness sharing: [OpenCode / Pi dual-device acceptance](docs/validation/cross-device-opencode-pi-2026-10.md); WorkBuddy / DSH: not fully host-validated ([report](docs/shared-memory/report.md))
|
|
630
|
+
- Crash / restart / idempotency: [bounded recovery](docs/recovery-benchmark.md)
|
|
631
|
+
- Authorization and isolation: [security](docs/security.md), [threat model](docs/shared-memory/threat-model-v1.md)
|
|
632
|
+
- Model quality: frozen evaluation datasets (see `scripts/evaluate.py`)
|
|
633
|
+
|
|
634
|
+
Long-running 24-hour acceptance: pending / not yet verified.
|
|
635
|
+
|
|
559
636
|
## License
|
|
560
637
|
|
|
561
638
|
MIT. Copyright © 2026 Kang Liu. See [LICENSE](LICENSE).
|
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
# Qdrant Memory for Hermes
|
|
2
2
|
|
|
3
|
+
**One Memory. Multiple Agents.**
|
|
4
|
+
|
|
5
|
+
Durable, portable, and permission-aware memory for AI agents.
|
|
6
|
+
|
|
7
|
+
Share persistent memory across AI harnesses, sessions, and devices through one
|
|
8
|
+
Qdrant-backed Runtime. Integrate using native providers, MCP, CLI, or Agent
|
|
9
|
+
Skills—with explicit access control, conflict-safe updates, and crash recovery.
|
|
10
|
+
|
|
3
11
|
Shared deployment hardening in this checkout is documented in the
|
|
4
12
|
[protected destination guide](docs/shared-memory/deployment-security.md) and
|
|
5
13
|
[versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
|
|
6
|
-
are included in Runtime 0.5.
|
|
14
|
+
are included in Runtime 0.5.2. Remote access needs the `[remote]` extra.
|
|
7
15
|
|
|
8
16
|
## One Memory, Multiple Agents — opt-in shared owner
|
|
9
17
|
|
|
@@ -16,17 +24,19 @@ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge.
|
|
|
16
24
|
[](https://www.python.org/downloads/)
|
|
17
25
|
[](LICENSE)
|
|
18
26
|
|
|
19
|
-
> **Runtime 0.5.
|
|
27
|
+
> **Runtime 0.5.2** keeps the opt-in authenticated local shared owner and the stdio
|
|
20
28
|
> bridge for explicit shared memory. It keeps the optional offline CPU embedding,
|
|
21
29
|
> trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
|
|
22
30
|
> Explicit writes retain canonical-text deduplication without an LLM.
|
|
23
|
-
> This
|
|
24
|
-
>
|
|
31
|
+
> This patch makes a restart-interrupted write replayable with the same request
|
|
32
|
+
> identifier. It changes no schema and no collection identity.
|
|
33
|
+
> This guide selects Runtime 0.5.2. Check its availability on
|
|
34
|
+
> [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) before installation.
|
|
25
35
|
> The generic MCP distribution and managed launcher select their own exact Runtime
|
|
26
36
|
> dependency and are released independently.
|
|
27
37
|
> The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
|
|
28
38
|
> does not upgrade it. One writer per destination remains required.
|
|
29
|
-
> See [release notes](docs/releases/0.5.
|
|
39
|
+
> See [release notes](docs/releases/0.5.2.md) and [validation](docs/validation.md).
|
|
30
40
|
|
|
31
41
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
32
42
|
|
|
@@ -44,7 +54,7 @@ as a community-maintained plugin.
|
|
|
44
54
|
## How it works
|
|
45
55
|
|
|
46
56
|
For non-Hermes users, install in a private Python 3.11+
|
|
47
|
-
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.
|
|
57
|
+
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.2'` (omit `[mcp]`
|
|
48
58
|
for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
|
|
49
59
|
Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
|
|
50
60
|
MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
|
|
@@ -55,14 +65,27 @@ an authorized upgrade, verify the same profile, collection and embedding pipelin
|
|
|
55
65
|
|
|
56
66
|
```mermaid
|
|
57
67
|
flowchart LR
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
68
|
+
subgraph Private["Private standalone path"]
|
|
69
|
+
turn["Hermes turn"] --> admit["Provider callback"]
|
|
70
|
+
admit --> ledger[("SQLite ledger<br/>durable admission")]
|
|
71
|
+
ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
|
|
72
|
+
extract --> store[("Qdrant<br/>dense vectors + payloads")]
|
|
73
|
+
ask["Recall / search"] --> search["Scoped dense search"]
|
|
74
|
+
search --> store
|
|
75
|
+
end
|
|
76
|
+
subgraph Shared["Shared owner path (opt-in)"]
|
|
77
|
+
agent["Agent A / B"] --> owner["Shared Owner<br/>auth + scope"]
|
|
78
|
+
owner --> lease["WriterLease<br/>(current profile only)"]
|
|
79
|
+
lease --> store2[("Qdrant<br/>shared space")]
|
|
80
|
+
owner --> ledger2[("SQLite ledger")]
|
|
81
|
+
end
|
|
82
|
+
store -.migration/portability.-> store2
|
|
64
83
|
```
|
|
65
84
|
|
|
85
|
+
`WriterLease` coordinates only the current profile's writes. It does not prevent
|
|
86
|
+
other profiles or devices from writing to the same destination. "One writer per
|
|
87
|
+
destination" is an operational constraint, not an automatic cross-device lock.
|
|
88
|
+
|
|
66
89
|
## Why this plugin
|
|
67
90
|
|
|
68
91
|
- Durable, private memory for Hermes Agent: conversations become searchable
|
|
@@ -109,6 +132,19 @@ cleans up the demo scope. All steps
|
|
|
109
132
|
run in embedded mode. `scripts/demo.sh` reproduces the same walkthrough with
|
|
110
133
|
the pinned release.
|
|
111
134
|
|
|
135
|
+
## Choose your setup
|
|
136
|
+
|
|
137
|
+
| Use case | Recommended entry | Notes |
|
|
138
|
+
|---|---|---|
|
|
139
|
+
| Hermes native automatic memory | Native MemoryProvider | Automatic extraction and recall inside Hermes |
|
|
140
|
+
| Single agent, standalone MCP | Standalone MCP (`qdrant-memory-mcp`) | Explicit tools only, no auto-extraction |
|
|
141
|
+
| Multiple agents sharing memory | Authenticated Shared Owner | Opt-in. One writer per destination |
|
|
142
|
+
| Remote / multi-device access | HTTPS MCP + Owner | TLS, auth and network protection required |
|
|
143
|
+
| WorkBuddy / DSH | Host integration guides | Reuse the same Runtime |
|
|
144
|
+
| Migrate Mem0 data | Migration CLI | Source IDs, resumable manifest, verification |
|
|
145
|
+
|
|
146
|
+
See [standalone setup](docs/standalone.md), [shared memory](docs/shared-memory/README.md), and [cross-harness architecture](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md).
|
|
147
|
+
|
|
112
148
|
## Install
|
|
113
149
|
|
|
114
150
|
Requirements: Python 3.11+, a compatible Hermes installation, and a reachable
|
|
@@ -122,7 +158,7 @@ Choose the **active profile's** home explicitly. Do not reuse another profile's
|
|
|
122
158
|
**Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
|
|
123
159
|
|
|
124
160
|
The Catalog selects its own fixed revision, which may be older than Runtime
|
|
125
|
-
0.5.
|
|
161
|
+
0.5.2. To use the current release, including opt-in shared memory, follow the
|
|
126
162
|
recommended version-locked installation below.
|
|
127
163
|
|
|
128
164
|
```bash
|
|
@@ -140,7 +176,7 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
|
|
|
140
176
|
tools, requirements and known issues before it clones anything.
|
|
141
177
|
`hermes plugins enable` prepares the declared dependencies through Hermes PM.
|
|
142
178
|
|
|
143
|
-
**Recommended: install the version-locked Runtime 0.5.
|
|
179
|
+
**Recommended: install the version-locked Runtime 0.5.2 source through the Hermes CLI.**
|
|
144
180
|
|
|
145
181
|
This immutable source revision includes opt-in shared memory. It does not depend
|
|
146
182
|
on a PyPI release or a catalog update.
|
|
@@ -150,7 +186,7 @@ export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
|
150
186
|
ollama pull qwen3-embedding:4b
|
|
151
187
|
# Start Ollama if it is not running. Keep its service available.
|
|
152
188
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
153
|
-
--ref
|
|
189
|
+
--ref 604793341226e45f04500cd1d53fd668ddf89d63 # Runtime 0.5.2 release
|
|
154
190
|
hermes plugins enable qdrant-memory
|
|
155
191
|
hermes memory setup
|
|
156
192
|
hermes config set memory.provider qdrant-memory
|
|
@@ -161,7 +197,7 @@ hermes qdrant-memory init
|
|
|
161
197
|
|
|
162
198
|
This older immutable source revision includes optional CPU embedding and guided
|
|
163
199
|
setup, but it predates opt-in shared memory. For the current release use
|
|
164
|
-
Runtime 0.5.
|
|
200
|
+
Runtime 0.5.2 above. It does not depend on a PyPI release or a catalog update.
|
|
165
201
|
|
|
166
202
|
```bash
|
|
167
203
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -185,7 +221,7 @@ environment. Omit `--ref` to track `main`, the development line.
|
|
|
185
221
|
**Historical release: clone a published tag manually.**
|
|
186
222
|
|
|
187
223
|
The v0.1.0 tag below predates the standalone interfaces and the explicit-write
|
|
188
|
-
fix. Use the pinned source above for Runtime 0.5.
|
|
224
|
+
fix. Use the pinned source above for Runtime 0.5.2.
|
|
189
225
|
|
|
190
226
|
```bash
|
|
191
227
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -465,6 +501,20 @@ and non-primary-agent turns. Treat recalled content as untrusted data. See
|
|
|
465
501
|
[security](docs/security.md), [operating procedures](docs/operations.md),
|
|
466
502
|
[troubleshooting](docs/troubleshooting.md) and [architecture](docs/architecture.md).
|
|
467
503
|
|
|
504
|
+
## Capabilities and limitations
|
|
505
|
+
|
|
506
|
+
| Area | Status | Notes |
|
|
507
|
+
|---|---|---|
|
|
508
|
+
| Private memory (standalone) | Supported | Embedded / server / Cloud Qdrant |
|
|
509
|
+
| Automatic extraction (Hermes) | Supported | Trusted `ctx.llm` facade |
|
|
510
|
+
| Automatic recall (Hermes) | Supported | Scoped dense search |
|
|
511
|
+
| Shared memory (Shared Owner) | Opt-in | One writer per destination (operational constraint, not cross-device lock). Not the default |
|
|
512
|
+
| Automatic shared extraction | Opt-in | Native Owner and opt-in Pi lifecycle adapter |
|
|
513
|
+
| MCP auto-extraction | Not supported | Explicit tools only |
|
|
514
|
+
| Hybrid search / reranking | Not supported | Dense retrieval only (v0.1) |
|
|
515
|
+
| Multi-writer Server/Cloud | Not supported | One authoritative writer |
|
|
516
|
+
| Web UI | Not supported | CLI and tools only |
|
|
517
|
+
|
|
468
518
|
## Compatibility and scope
|
|
469
519
|
|
|
470
520
|
Version 0.1 implements dense retrieval. Hybrid sparse vectors, RRF/DBSF, reranking
|
|
@@ -529,6 +579,33 @@ for a separate synthetic replay and retained-storage measurement.
|
|
|
529
579
|
CI runs tests, SonarCloud quality gates and Snyk dependency/code scans.
|
|
530
580
|
See [CI service setup](docs/ci.md) and [validation evidence](docs/validation.md).
|
|
531
581
|
|
|
582
|
+
## Documentation
|
|
583
|
+
|
|
584
|
+
- [Getting started / standalone](docs/standalone.md)
|
|
585
|
+
- [Architecture](docs/architecture.md)
|
|
586
|
+
- [Configuration](docs/configuration.md)
|
|
587
|
+
- [Cross-harness sharing (MCP repo)](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md)
|
|
588
|
+
- [Shared memory](docs/shared-memory/README.md)
|
|
589
|
+
- [Security](docs/security.md)
|
|
590
|
+
- [Operations](docs/operations.md)
|
|
591
|
+
- [Migration from Mem0](docs/migration-from-mem0.md)
|
|
592
|
+
- [Backup and portability](docs/portability.md)
|
|
593
|
+
- [Validation and evidence](docs/validation.md)
|
|
594
|
+
- [Development](docs/development.md)
|
|
595
|
+
- [CI](docs/ci.md)
|
|
596
|
+
|
|
597
|
+
## Validation and evidence
|
|
598
|
+
|
|
599
|
+
Real evidence, not badges:
|
|
600
|
+
|
|
601
|
+
- Hermes native lifecycle tests: [validation](docs/validation.md)
|
|
602
|
+
- Cross-harness sharing: [OpenCode / Pi dual-device acceptance](docs/validation/cross-device-opencode-pi-2026-10.md); WorkBuddy / DSH: not fully host-validated ([report](docs/shared-memory/report.md))
|
|
603
|
+
- Crash / restart / idempotency: [bounded recovery](docs/recovery-benchmark.md)
|
|
604
|
+
- Authorization and isolation: [security](docs/security.md), [threat model](docs/shared-memory/threat-model-v1.md)
|
|
605
|
+
- Model quality: frozen evaluation datasets (see `scripts/evaluate.py`)
|
|
606
|
+
|
|
607
|
+
Long-running 24-hour acceptance: pending / not yet verified.
|
|
608
|
+
|
|
532
609
|
## License
|
|
533
610
|
|
|
534
611
|
MIT. Copyright © 2026 Kang Liu. See [LICENSE](LICENSE).
|
{hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/docs/local-embedding.md
RENAMED
|
@@ -35,11 +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.
|
|
39
|
-
Runtime 0.5.
|
|
38
|
+
Check [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) for
|
|
39
|
+
Runtime 0.5.2 availability before running this command.
|
|
40
40
|
|
|
41
41
|
```sh
|
|
42
|
-
python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.5.
|
|
42
|
+
python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.5.2'
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
Choose **one** setup command and replace the profile path with a new absolute
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: hermes-plugin-qdrant-memory
|
|
3
|
-
Version: 0.5.
|
|
3
|
+
Version: 0.5.2
|
|
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
|
|
@@ -27,10 +27,18 @@ Dynamic: license-file
|
|
|
27
27
|
|
|
28
28
|
# Qdrant Memory for Hermes
|
|
29
29
|
|
|
30
|
+
**One Memory. Multiple Agents.**
|
|
31
|
+
|
|
32
|
+
Durable, portable, and permission-aware memory for AI agents.
|
|
33
|
+
|
|
34
|
+
Share persistent memory across AI harnesses, sessions, and devices through one
|
|
35
|
+
Qdrant-backed Runtime. Integrate using native providers, MCP, CLI, or Agent
|
|
36
|
+
Skills—with explicit access control, conflict-safe updates, and crash recovery.
|
|
37
|
+
|
|
30
38
|
Shared deployment hardening in this checkout is documented in the
|
|
31
39
|
[protected destination guide](docs/shared-memory/deployment-security.md) and
|
|
32
40
|
[versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
|
|
33
|
-
are included in Runtime 0.5.
|
|
41
|
+
are included in Runtime 0.5.2. Remote access needs the `[remote]` extra.
|
|
34
42
|
|
|
35
43
|
## One Memory, Multiple Agents — opt-in shared owner
|
|
36
44
|
|
|
@@ -43,17 +51,19 @@ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge.
|
|
|
43
51
|
[](https://www.python.org/downloads/)
|
|
44
52
|
[](LICENSE)
|
|
45
53
|
|
|
46
|
-
> **Runtime 0.5.
|
|
54
|
+
> **Runtime 0.5.2** keeps the opt-in authenticated local shared owner and the stdio
|
|
47
55
|
> bridge for explicit shared memory. It keeps the optional offline CPU embedding,
|
|
48
56
|
> trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
|
|
49
57
|
> Explicit writes retain canonical-text deduplication without an LLM.
|
|
50
|
-
> This
|
|
51
|
-
>
|
|
58
|
+
> This patch makes a restart-interrupted write replayable with the same request
|
|
59
|
+
> identifier. It changes no schema and no collection identity.
|
|
60
|
+
> This guide selects Runtime 0.5.2. Check its availability on
|
|
61
|
+
> [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) before installation.
|
|
52
62
|
> The generic MCP distribution and managed launcher select their own exact Runtime
|
|
53
63
|
> dependency and are released independently.
|
|
54
64
|
> The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
|
|
55
65
|
> does not upgrade it. One writer per destination remains required.
|
|
56
|
-
> See [release notes](docs/releases/0.5.
|
|
66
|
+
> See [release notes](docs/releases/0.5.2.md) and [validation](docs/validation.md).
|
|
57
67
|
|
|
58
68
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
59
69
|
|
|
@@ -71,7 +81,7 @@ as a community-maintained plugin.
|
|
|
71
81
|
## How it works
|
|
72
82
|
|
|
73
83
|
For non-Hermes users, install in a private Python 3.11+
|
|
74
|
-
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.
|
|
84
|
+
environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.2'` (omit `[mcp]`
|
|
75
85
|
for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
|
|
76
86
|
Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
|
|
77
87
|
MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
|
|
@@ -82,14 +92,27 @@ an authorized upgrade, verify the same profile, collection and embedding pipelin
|
|
|
82
92
|
|
|
83
93
|
```mermaid
|
|
84
94
|
flowchart LR
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
95
|
+
subgraph Private["Private standalone path"]
|
|
96
|
+
turn["Hermes turn"] --> admit["Provider callback"]
|
|
97
|
+
admit --> ledger[("SQLite ledger<br/>durable admission")]
|
|
98
|
+
ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
|
|
99
|
+
extract --> store[("Qdrant<br/>dense vectors + payloads")]
|
|
100
|
+
ask["Recall / search"] --> search["Scoped dense search"]
|
|
101
|
+
search --> store
|
|
102
|
+
end
|
|
103
|
+
subgraph Shared["Shared owner path (opt-in)"]
|
|
104
|
+
agent["Agent A / B"] --> owner["Shared Owner<br/>auth + scope"]
|
|
105
|
+
owner --> lease["WriterLease<br/>(current profile only)"]
|
|
106
|
+
lease --> store2[("Qdrant<br/>shared space")]
|
|
107
|
+
owner --> ledger2[("SQLite ledger")]
|
|
108
|
+
end
|
|
109
|
+
store -.migration/portability.-> store2
|
|
91
110
|
```
|
|
92
111
|
|
|
112
|
+
`WriterLease` coordinates only the current profile's writes. It does not prevent
|
|
113
|
+
other profiles or devices from writing to the same destination. "One writer per
|
|
114
|
+
destination" is an operational constraint, not an automatic cross-device lock.
|
|
115
|
+
|
|
93
116
|
## Why this plugin
|
|
94
117
|
|
|
95
118
|
- Durable, private memory for Hermes Agent: conversations become searchable
|
|
@@ -136,6 +159,19 @@ cleans up the demo scope. All steps
|
|
|
136
159
|
run in embedded mode. `scripts/demo.sh` reproduces the same walkthrough with
|
|
137
160
|
the pinned release.
|
|
138
161
|
|
|
162
|
+
## Choose your setup
|
|
163
|
+
|
|
164
|
+
| Use case | Recommended entry | Notes |
|
|
165
|
+
|---|---|---|
|
|
166
|
+
| Hermes native automatic memory | Native MemoryProvider | Automatic extraction and recall inside Hermes |
|
|
167
|
+
| Single agent, standalone MCP | Standalone MCP (`qdrant-memory-mcp`) | Explicit tools only, no auto-extraction |
|
|
168
|
+
| Multiple agents sharing memory | Authenticated Shared Owner | Opt-in. One writer per destination |
|
|
169
|
+
| Remote / multi-device access | HTTPS MCP + Owner | TLS, auth and network protection required |
|
|
170
|
+
| WorkBuddy / DSH | Host integration guides | Reuse the same Runtime |
|
|
171
|
+
| Migrate Mem0 data | Migration CLI | Source IDs, resumable manifest, verification |
|
|
172
|
+
|
|
173
|
+
See [standalone setup](docs/standalone.md), [shared memory](docs/shared-memory/README.md), and [cross-harness architecture](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md).
|
|
174
|
+
|
|
139
175
|
## Install
|
|
140
176
|
|
|
141
177
|
Requirements: Python 3.11+, a compatible Hermes installation, and a reachable
|
|
@@ -149,7 +185,7 @@ Choose the **active profile's** home explicitly. Do not reuse another profile's
|
|
|
149
185
|
**Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
|
|
150
186
|
|
|
151
187
|
The Catalog selects its own fixed revision, which may be older than Runtime
|
|
152
|
-
0.5.
|
|
188
|
+
0.5.2. To use the current release, including opt-in shared memory, follow the
|
|
153
189
|
recommended version-locked installation below.
|
|
154
190
|
|
|
155
191
|
```bash
|
|
@@ -167,7 +203,7 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
|
|
|
167
203
|
tools, requirements and known issues before it clones anything.
|
|
168
204
|
`hermes plugins enable` prepares the declared dependencies through Hermes PM.
|
|
169
205
|
|
|
170
|
-
**Recommended: install the version-locked Runtime 0.5.
|
|
206
|
+
**Recommended: install the version-locked Runtime 0.5.2 source through the Hermes CLI.**
|
|
171
207
|
|
|
172
208
|
This immutable source revision includes opt-in shared memory. It does not depend
|
|
173
209
|
on a PyPI release or a catalog update.
|
|
@@ -177,7 +213,7 @@ export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
|
177
213
|
ollama pull qwen3-embedding:4b
|
|
178
214
|
# Start Ollama if it is not running. Keep its service available.
|
|
179
215
|
hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
|
|
180
|
-
--ref
|
|
216
|
+
--ref 604793341226e45f04500cd1d53fd668ddf89d63 # Runtime 0.5.2 release
|
|
181
217
|
hermes plugins enable qdrant-memory
|
|
182
218
|
hermes memory setup
|
|
183
219
|
hermes config set memory.provider qdrant-memory
|
|
@@ -188,7 +224,7 @@ hermes qdrant-memory init
|
|
|
188
224
|
|
|
189
225
|
This older immutable source revision includes optional CPU embedding and guided
|
|
190
226
|
setup, but it predates opt-in shared memory. For the current release use
|
|
191
|
-
Runtime 0.5.
|
|
227
|
+
Runtime 0.5.2 above. It does not depend on a PyPI release or a catalog update.
|
|
192
228
|
|
|
193
229
|
```bash
|
|
194
230
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -212,7 +248,7 @@ environment. Omit `--ref` to track `main`, the development line.
|
|
|
212
248
|
**Historical release: clone a published tag manually.**
|
|
213
249
|
|
|
214
250
|
The v0.1.0 tag below predates the standalone interfaces and the explicit-write
|
|
215
|
-
fix. Use the pinned source above for Runtime 0.5.
|
|
251
|
+
fix. Use the pinned source above for Runtime 0.5.2.
|
|
216
252
|
|
|
217
253
|
```bash
|
|
218
254
|
export HERMES_HOME="/absolute/path/to/your/hermes-profile"
|
|
@@ -492,6 +528,20 @@ and non-primary-agent turns. Treat recalled content as untrusted data. See
|
|
|
492
528
|
[security](docs/security.md), [operating procedures](docs/operations.md),
|
|
493
529
|
[troubleshooting](docs/troubleshooting.md) and [architecture](docs/architecture.md).
|
|
494
530
|
|
|
531
|
+
## Capabilities and limitations
|
|
532
|
+
|
|
533
|
+
| Area | Status | Notes |
|
|
534
|
+
|---|---|---|
|
|
535
|
+
| Private memory (standalone) | Supported | Embedded / server / Cloud Qdrant |
|
|
536
|
+
| Automatic extraction (Hermes) | Supported | Trusted `ctx.llm` facade |
|
|
537
|
+
| Automatic recall (Hermes) | Supported | Scoped dense search |
|
|
538
|
+
| Shared memory (Shared Owner) | Opt-in | One writer per destination (operational constraint, not cross-device lock). Not the default |
|
|
539
|
+
| Automatic shared extraction | Opt-in | Native Owner and opt-in Pi lifecycle adapter |
|
|
540
|
+
| MCP auto-extraction | Not supported | Explicit tools only |
|
|
541
|
+
| Hybrid search / reranking | Not supported | Dense retrieval only (v0.1) |
|
|
542
|
+
| Multi-writer Server/Cloud | Not supported | One authoritative writer |
|
|
543
|
+
| Web UI | Not supported | CLI and tools only |
|
|
544
|
+
|
|
495
545
|
## Compatibility and scope
|
|
496
546
|
|
|
497
547
|
Version 0.1 implements dense retrieval. Hybrid sparse vectors, RRF/DBSF, reranking
|
|
@@ -556,6 +606,33 @@ for a separate synthetic replay and retained-storage measurement.
|
|
|
556
606
|
CI runs tests, SonarCloud quality gates and Snyk dependency/code scans.
|
|
557
607
|
See [CI service setup](docs/ci.md) and [validation evidence](docs/validation.md).
|
|
558
608
|
|
|
609
|
+
## Documentation
|
|
610
|
+
|
|
611
|
+
- [Getting started / standalone](docs/standalone.md)
|
|
612
|
+
- [Architecture](docs/architecture.md)
|
|
613
|
+
- [Configuration](docs/configuration.md)
|
|
614
|
+
- [Cross-harness sharing (MCP repo)](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md)
|
|
615
|
+
- [Shared memory](docs/shared-memory/README.md)
|
|
616
|
+
- [Security](docs/security.md)
|
|
617
|
+
- [Operations](docs/operations.md)
|
|
618
|
+
- [Migration from Mem0](docs/migration-from-mem0.md)
|
|
619
|
+
- [Backup and portability](docs/portability.md)
|
|
620
|
+
- [Validation and evidence](docs/validation.md)
|
|
621
|
+
- [Development](docs/development.md)
|
|
622
|
+
- [CI](docs/ci.md)
|
|
623
|
+
|
|
624
|
+
## Validation and evidence
|
|
625
|
+
|
|
626
|
+
Real evidence, not badges:
|
|
627
|
+
|
|
628
|
+
- Hermes native lifecycle tests: [validation](docs/validation.md)
|
|
629
|
+
- Cross-harness sharing: [OpenCode / Pi dual-device acceptance](docs/validation/cross-device-opencode-pi-2026-10.md); WorkBuddy / DSH: not fully host-validated ([report](docs/shared-memory/report.md))
|
|
630
|
+
- Crash / restart / idempotency: [bounded recovery](docs/recovery-benchmark.md)
|
|
631
|
+
- Authorization and isolation: [security](docs/security.md), [threat model](docs/shared-memory/threat-model-v1.md)
|
|
632
|
+
- Model quality: frozen evaluation datasets (see `scripts/evaluate.py`)
|
|
633
|
+
|
|
634
|
+
Long-running 24-hour acceptance: pending / not yet verified.
|
|
635
|
+
|
|
559
636
|
## License
|
|
560
637
|
|
|
561
638
|
MIT. Copyright © 2026 Kang Liu. See [LICENSE](LICENSE).
|