hermes-memory-libravdb 0.5.1__tar.gz

hermes_memory_libravdb-0.5.1/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: hermes-memory-libravdb
+Version: 0.5.1
+Summary: Native LibraVDB memory provider for Hermes Agent using real gRPC
+Requires-Python: >=3.9
+Requires-Dist: grpcio>=1.60
+Requires-Dist: libravdb-contracts>=2.0.5
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"

hermes_memory_libravdb-0.5.1/README.md

@@ -0,0 +1,161 @@
+# ♎ LibraVDB - Memory and Context Management
+
+<div align="center">
+  <img src="./docs/assets/libravdb-logo.svg" alt="LibraVDB" width="640">
+</div>
+
+<div align="center">
+  <a href="https://github.com/xDarkicex/libravdbd"><img src="https://img.shields.io/badge/Go-1.25%2B-00ADD8?logo=go&logoColor=white" alt="Go 1.25+"></a>
+  <a href="./pyproject.toml"><img src="https://img.shields.io/badge/Python-3.9%2B-3776AB?logo=python&logoColor=white" alt="Python 3.9+"></a>
+  <a href="./plugin.yaml"><img src="https://img.shields.io/badge/Hermes-memory%20provider-00D8FF?logo=hermes&logoColor=white" alt="Hermes memory provider"></a>
+  <a href="https://pypi.org/project/hermes-memory-libravdb/"><img src="https://img.shields.io/pypi/v/hermes-memory-libravdb?label=release&color=5B21B6" alt="Release"></a>
+</div>
+
+`hermes-memory-libravdb` is a native Python memory provider for Hermes Agent
+backed by the `libravdbd` vector service. It replaces the lightweight default memory
+path with scoped session, user, and global memory; continuity-aware prompt
+assembly; durable recall; and sidecar-owned compaction.
+
+[Install](./docs/install.md) · [Configuration](./docs/configuration.md) · [Architecture](./docs/architecture.md) · [Security](./docs/security.md) · [Contributing](./docs/contributing.md)
+
+New install? Start here: [Install guide](./docs/install.md).
+
+## Install
+
+Install `libravdbd` with your system package manager, then install
+the Hermes plugin.
+
+**macOS (Homebrew)**
+
+```bash
+brew tap xDarkicex/homebrew-libravdbd
+brew install libravdbd
+brew services start libravdbd
+```
+
+**Linux (APT)**
+
+```bash
+sudo apt install libravdbd
+systemctl --user enable --now libravdbd
+```
+
+**Plugin (all platforms)**
+
+```bash
+pip install hermes-memory-libravdb
+```
+
+Then configure the plugin in `~/.hermes/plugins/memory/libravdb/` or via
+`hermes memory setup` and select `libravdb` as the memory provider.
+
+Verify the service:
+
+```bash
+hermes libravdb status
+```
+
+Healthy output should show `ok: true`, stored memory counts, and the active
+gate threshold.
+
+## Quick Start
+
+Runtime requirements:
+
+- Hermes Agent `>= 0.9`
+- Python `>= 3.9`
+- a separately installed `libravdbd` service
+
+Compatibility note:
+
+- this plugin is currently verified against Hermes Agent `0.9.x`
+
+Default endpoint:
+
+- macOS/Linux user-local service: `unix:$HOME/.libravdbd/run/libravdb.sock`
+- Homebrew service on Apple Silicon: `unix:/opt/homebrew/var/libravdbd/run/libravdb.sock`
+
+If your service runs elsewhere, set the `LIBRAVDB_GRPC_ENDPOINT` environment variable:
+
+```bash
+export LIBRAVDB_GRPC_ENDPOINT="tcp:127.0.0.1:37421"
+```
+
+## Highlights
+
+- **Native gRPC** — direct connection to `libravdbd` using Connect-RPC compatible protocol
+- **HMAC nonce authentication** — same secure challenge-response scheme as the TypeScript plugin
+- **Three memory scopes** — keeps active session, durable user, and global memory separate
+- **Hybrid retrieval** — blends semantic similarity, scope, recency, and summary quality
+- **Continuity-aware assembly** — preserves the recent working tail while fitting recalled memory into a bounded prompt budget
+- **Background turn sync** — asynchronous message ingestion that doesn't block the UI
+- **Local-first inference** — uses local embedding and compaction paths by default
+
+## Security Defaults
+
+Stored memory is treated as untrusted historical context. Retrieved memory is
+framed before it reaches the downstream model, memory collections are scoped by
+session/user/global namespace, and service installation is outside the Python package.
+
+Before exposing Hermes over remote channels, read [Security](./docs/security.md).
+
+## Operator Quick Refs
+
+```bash
+hermes libravdb status              # daemon health, collection counts
+hermes libravdb health              # quick liveness check
+hermes libravdb search "query"      # semantic memory search
+hermes libravdb flush --user-id X   # wipe user namespace
+hermes libravdb export --user-id X  # NDJSON memory export
+hermes libravdb journal --session-id X  # lifecycle journal
+hermes libravdb index --user-id X --force  # rebuild search index
+```
+
+## Configuration
+
+Provider config lives in `$HERMES_HOME/libravdb.json`. All keys are optional. For the full 60+ key reference, see [Configuration](./docs/configuration.md).
+
+| Key | Type | Default | |
+|---|---|---|---|
+| `endpoint` | string | `auto` | `"auto"` probes standard paths; set `unix:/path` or `tcp:host:port` to override |
+| `userId` | string | auto-derived | Stable identity for cross-session durable memory |
+| `topK` | number | `8` | Default number of recalled memory hits |
+| `minScore` | number | `0.35` | Minimum semantic score for prefetched/tool search results |
+
+Set `memory.provider: "libravdb"` in Hermes `config.yaml` to activate. Run `hermes memory setup` for guided configuration.
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `LIBRAVDB_GRPC_ENDPOINT` | gRPC endpoint (e.g., `unix:/path` or `tcp:host:port`) |
+| `LIBRAVDB_AUTH_SECRET` | HMAC secret for daemon authentication |
+| `LIBRAVDB_AUTH_SECRET_FILE` | Path to file containing HMAC secret |
+| `HERMES_HOME` | Hermes configuration directory (default: `~/.hermes`) |
+
+## Docs By Goal
+
+- New install: [Install](./docs/install.md)
+- Verify your setup: [Beta Tester Checklist](./docs/beta-checklist.md)
+- Understand the design: [Architecture](./docs/architecture.md)
+- How it fits Hermes: [Hermes Integration](./docs/hermes-integration.md)
+- Configure: [Configuration](./docs/configuration.md), [TLS configuration](./docs/TLS_configuration.md)
+- Operate safely: [Security](./docs/security.md), [Uninstall](./docs/uninstall.md)
+- Contributing: [Contributing](./docs/contributing.md)
+
+## From Source
+
+```bash
+pip install -e .
+pip install -e ".[dev]"
+pytest
+```
+
+## Runtime Facts
+
+- PyPI package: `hermes-memory-libravdb`
+- Hermes plugin kind: `memory`
+- Hermes memory provider name: `libravdb`
+- minimum Python version: `>= 3.9`
+- default data path: `$HOME/.libravdbd/data_nomic-embed-text-v1_5.libravdb`
+- default macOS/Linux endpoint: `unix:$HOME/.libravdbd/run/libravdb.sock`

hermes_memory_libravdb-0.5.1/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hermes-memory-libravdb"
+version = "0.5.1"
+description = "Native LibraVDB memory provider for Hermes Agent using real gRPC"
+requires-python = ">=3.9"
+dependencies = [
+    "grpcio>=1.60",
+    "libravdb-contracts>=2.0.5",
+]
+
+[project.entry-points."hermes_agent.plugins"]
+libravdb-memory = "hermes_memory_libravdb:register"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+hermes_memory_libravdb = ["py.typed"]

hermes_memory_libravdb-0.5.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+