hermes-xmemo 1.0.0__tar.gz

hermes_xmemo-1.0.0/.github/workflows/pypi-publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+"on":
+  push:
+    tags:
+      - "v*.*.*"
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    name: Build and publish Python package
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/hermes-xmemo
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

hermes_xmemo-1.0.0/.gitignore

@@ -0,0 +1,13 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+
+# Hermes runtime state (if someone runs from inside the repo)
+.env
+xmemo.json

hermes_xmemo-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XMemo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hermes_xmemo-1.0.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: hermes-xmemo
+Version: 1.0.0
+Summary: XMemo memory provider plugin for Hermes Agent
+Author: XMemo
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yonro/hermes-xmemo-plugin
+Project-URL: Repository, https://github.com/yonro/hermes-xmemo-plugin
+Project-URL: Issues, https://github.com/yonro/hermes-xmemo-plugin/issues
+Keywords: hermes,agent,memory,xmemo,plugin
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Dynamic: license-file
+
+# XMemo Memory Provider for Hermes Agent
+
+[XMemo](https://xmemo.dev) is an identity-aware memory layer for AI agents: one persistent, user-owned memory space that works across ChatGPT, Copilot, Claude, Codex, Gemini, and here — Hermes Agent. Every memory entry knows who wrote it, so you can recall, audit, and control context without confusion or spillover.
+
+This plugin connects Hermes Agent to your XMemo account, giving the agent durable memory that survives sessions and long-running workflows, with per-profile isolation.
+
+## What it does
+
+- **Orchestrated recall** — Hermes prefetches relevant XMemo context before each turn, automatically.
+- **Semantic search** — ask the agent to search saved facts with natural language (`xmemo_search`).
+- **Durable fact storage** — store explicit facts, preferences, and decisions (`xmemo_remember`).
+- **Working state with TTL** — save active task, next action, or blocker so future sessions can resume (`xmemo_update_state`).
+- **Built-in memory mirroring** — when Hermes' native `memory` tool writes, the same fact is mirrored to XMemo.
+- **Session snapshots** — captures a restart snapshot at session end for later restoration by compatible XMemo workflows.
+- **Reminders & timeline** — optional workflow tools for TODOs and timeline events (opt-in via config).
+- **Profile isolation** — each Hermes profile uses its own `xmemo.json` and scoped memories.
+- **Resilient by default** — circuit breaker pauses API calls after consecutive failures; background prefetch/sync never block the chat.
+
+## Install
+
+Hermes looks for memory provider plugins in `$HERMES_HOME/plugins/<name>/`. The default `HERMES_HOME` is `~/.hermes`.
+
+### pip install (recommended)
+
+```bash
+pip install hermes-xmemo
+hermes-xmemo install
+hermes memory setup xmemo
+```
+
+To install to a non-default Hermes home:
+
+```bash
+HERMES_HOME=/path/to/your/hermes-home hermes-xmemo install
+```
+
+### One-liner (no pip)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/yonro/hermes-xmemo-plugin/main/install-remote.sh | bash
+hermes memory setup xmemo
+```
+
+### Using install.sh (if you already cloned)
+
+```bash
+cd hermes-xmemo-plugin
+bash install.sh
+```
+
+### Manual install
+
+```bash
+# Remove any previous install first to avoid nested directories.
+rm -rf "${HERMES_HOME:-$HOME/.hermes}/plugins/xmemo"
+mkdir -p "${HERMES_HOME:-$HOME/.hermes}/plugins"
+cp -r src/hermes_xmemo/xmemo "${HERMES_HOME:-$HOME/.hermes}/plugins/"
+```
+
+### Configure
+
+```bash
+hermes memory setup xmemo
+```
+
+Or manually:
+
+```bash
+hermes config set memory.provider xmemo
+echo "XMEMO_KEY=your-token" >> "${HERMES_HOME:-$HOME/.hermes}/.env"
+```
+
+## Requirements
+
+- Hermes Agent (the plugin is loaded by Hermes at runtime)
+- `httpx` (already a dependency of Hermes)
+- XMemo service token from [xmemo.dev](https://xmemo.dev)
+
+## How it works
+
+1. **Before the turn** — Hermes calls `prefetch()` to retrieve relevant XMemo context and injects it into the conversation.
+2. **During the turn** — the agent can call explicit XMemo tools (`xmemo_search`, `xmemo_remember`, etc.).
+3. **After the turn** — high-signal turns can be recorded to the XMemo timeline if `capture_timeline` is enabled.
+4. **Session end** — a restart snapshot is captured for later restoration by compatible XMemo workflows.
+
+Automatic prefetch, turn sync, and session snapshots run in the background. Explicit tool calls and memory mirroring use bounded timeouts, with a circuit breaker protecting Hermes from repeated failures.
+
+## Configure
+
+Edit `$HERMES_HOME/xmemo.json`:
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `base_url` | `https://xmemo.dev` | XMemo service URL |
+| `agent_id` | `hermes` | Agent family identifier |
+| `agent_instance_id` | auto-generated | Stable, opaque install identifier |
+| `bucket` | `work` | Storage namespace |
+| `scope` | `hermes/default` | Project/session scope |
+| `timeout_seconds` | `5.0` | REST request timeout |
+| `prefetch_max_items` | `5` | Max context items per recall |
+| `prefetch_max_tokens` | `900` | Max context tokens per recall |
+| `enable_workflow_tools` | `false` | Expose reminder/event tools |
+| `enable_destructive_tools` | `false` | Expose `xmemo_forget` |
+| `capture_timeline` | `false` | Record high-signal turns to timeline |
+
+### Environment variables
+
+You can override most settings via environment variables (useful for CI or containerized setups):
+
+| Variable | Overrides |
+|----------|-----------|
+| `XMEMO_KEY` | API key (required; `MEMORY_OS_API_KEY` is also accepted) |
+| `XMEMO_URL` | `base_url` (`MEMORY_OS_URL` is also accepted) |
+| `XMEMO_AGENT_ID` | `agent_id` |
+| `XMEMO_AGENT_INSTANCE_ID` | `agent_instance_id` |
+| `XMEMO_BUCKET` | `bucket` |
+| `XMEMO_SCOPE` | `scope` |
+| `XMEMO_TIMEOUT_SECONDS` | `timeout_seconds` |
+| `XMEMO_PREFETCH_MAX_ITEMS` | `prefetch_max_items` |
+| `XMEMO_PREFETCH_MAX_TOKENS` | `prefetch_max_tokens` |
+
+## Tools
+
+### Default tools
+
+These tools are always available:
+
+| Tool | Description |
+|------|-------------|
+| `xmemo_recall_context` | Build a bounded, ranked context pack |
+| `xmemo_search` | Semantic search over XMemo memories |
+| `xmemo_remember` | Save a durable fact |
+| `xmemo_update_state` | Save active task / next action / blocker with TTL |
+
+### Optional workflow tools
+
+Set `enable_workflow_tools: true` in `xmemo.json` to expose:
+
+| Tool | Description |
+|------|-------------|
+| `xmemo_record_event` | Append a timeline event or milestone |
+| `xmemo_create_reminder` | Create a TODO / action item |
+| `xmemo_list_reminders` | List open or completed reminders |
+| `xmemo_complete_reminder` | Mark a reminder as completed |
+
+### Optional destructive tool
+
+Set `enable_destructive_tools: true` to expose:
+
+| Tool | Description |
+|------|-------------|
+| `xmemo_forget` | Delete a memory by exact id |
+
+## Privacy & security
+
+- API keys live in `$HERMES_HOME/.env`, never in `xmemo.json`.
+- `xmemo_forget` requires an exact memory id and is disabled by default.
+- Automatic timeline writes are disabled by default. When enabled, only high-signal turns (decisions, preferences, blockers, etc.) are recorded.
+- Built-in `memory` tool writes are mirrored to XMemo only when the provider is active.
+- Prefetch cache is isolated per session, so concurrent gateway sessions cannot cross-contaminate recall context.
+
+## Uninstall or disable
+
+To disable XMemo without removing files:
+
+```bash
+hermes config set memory.provider ""
+```
+
+To remove the plugin entirely:
+
+```bash
+rm -rf "${HERMES_HOME:-$HOME/.hermes}/plugins/xmemo"
+```
+
+## Learn more
+
+- [xmemo.dev](https://xmemo.dev) — XMemo home
+- [Hermes Agent docs: Memory Providers](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers)
+
+## License
+
+MIT

hermes_xmemo-1.0.0/README.md

@@ -0,0 +1,183 @@
+# XMemo Memory Provider for Hermes Agent
+
+[XMemo](https://xmemo.dev) is an identity-aware memory layer for AI agents: one persistent, user-owned memory space that works across ChatGPT, Copilot, Claude, Codex, Gemini, and here — Hermes Agent. Every memory entry knows who wrote it, so you can recall, audit, and control context without confusion or spillover.
+
+This plugin connects Hermes Agent to your XMemo account, giving the agent durable memory that survives sessions and long-running workflows, with per-profile isolation.
+
+## What it does
+
+- **Orchestrated recall** — Hermes prefetches relevant XMemo context before each turn, automatically.
+- **Semantic search** — ask the agent to search saved facts with natural language (`xmemo_search`).
+- **Durable fact storage** — store explicit facts, preferences, and decisions (`xmemo_remember`).
+- **Working state with TTL** — save active task, next action, or blocker so future sessions can resume (`xmemo_update_state`).
+- **Built-in memory mirroring** — when Hermes' native `memory` tool writes, the same fact is mirrored to XMemo.
+- **Session snapshots** — captures a restart snapshot at session end for later restoration by compatible XMemo workflows.
+- **Reminders & timeline** — optional workflow tools for TODOs and timeline events (opt-in via config).
+- **Profile isolation** — each Hermes profile uses its own `xmemo.json` and scoped memories.
+- **Resilient by default** — circuit breaker pauses API calls after consecutive failures; background prefetch/sync never block the chat.
+
+## Install
+
+Hermes looks for memory provider plugins in `$HERMES_HOME/plugins/<name>/`. The default `HERMES_HOME` is `~/.hermes`.
+
+### pip install (recommended)
+
+```bash
+pip install hermes-xmemo
+hermes-xmemo install
+hermes memory setup xmemo
+```
+
+To install to a non-default Hermes home:
+
+```bash
+HERMES_HOME=/path/to/your/hermes-home hermes-xmemo install
+```
+
+### One-liner (no pip)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/yonro/hermes-xmemo-plugin/main/install-remote.sh | bash
+hermes memory setup xmemo
+```
+
+### Using install.sh (if you already cloned)
+
+```bash
+cd hermes-xmemo-plugin
+bash install.sh
+```
+
+### Manual install
+
+```bash
+# Remove any previous install first to avoid nested directories.
+rm -rf "${HERMES_HOME:-$HOME/.hermes}/plugins/xmemo"
+mkdir -p "${HERMES_HOME:-$HOME/.hermes}/plugins"
+cp -r src/hermes_xmemo/xmemo "${HERMES_HOME:-$HOME/.hermes}/plugins/"
+```
+
+### Configure
+
+```bash
+hermes memory setup xmemo
+```
+
+Or manually:
+
+```bash
+hermes config set memory.provider xmemo
+echo "XMEMO_KEY=your-token" >> "${HERMES_HOME:-$HOME/.hermes}/.env"
+```
+
+## Requirements
+
+- Hermes Agent (the plugin is loaded by Hermes at runtime)
+- `httpx` (already a dependency of Hermes)
+- XMemo service token from [xmemo.dev](https://xmemo.dev)
+
+## How it works
+
+1. **Before the turn** — Hermes calls `prefetch()` to retrieve relevant XMemo context and injects it into the conversation.
+2. **During the turn** — the agent can call explicit XMemo tools (`xmemo_search`, `xmemo_remember`, etc.).
+3. **After the turn** — high-signal turns can be recorded to the XMemo timeline if `capture_timeline` is enabled.
+4. **Session end** — a restart snapshot is captured for later restoration by compatible XMemo workflows.
+
+Automatic prefetch, turn sync, and session snapshots run in the background. Explicit tool calls and memory mirroring use bounded timeouts, with a circuit breaker protecting Hermes from repeated failures.
+
+## Configure
+
+Edit `$HERMES_HOME/xmemo.json`:
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `base_url` | `https://xmemo.dev` | XMemo service URL |
+| `agent_id` | `hermes` | Agent family identifier |
+| `agent_instance_id` | auto-generated | Stable, opaque install identifier |
+| `bucket` | `work` | Storage namespace |
+| `scope` | `hermes/default` | Project/session scope |
+| `timeout_seconds` | `5.0` | REST request timeout |
+| `prefetch_max_items` | `5` | Max context items per recall |
+| `prefetch_max_tokens` | `900` | Max context tokens per recall |
+| `enable_workflow_tools` | `false` | Expose reminder/event tools |
+| `enable_destructive_tools` | `false` | Expose `xmemo_forget` |
+| `capture_timeline` | `false` | Record high-signal turns to timeline |
+
+### Environment variables
+
+You can override most settings via environment variables (useful for CI or containerized setups):
+
+| Variable | Overrides |
+|----------|-----------|
+| `XMEMO_KEY` | API key (required; `MEMORY_OS_API_KEY` is also accepted) |
+| `XMEMO_URL` | `base_url` (`MEMORY_OS_URL` is also accepted) |
+| `XMEMO_AGENT_ID` | `agent_id` |
+| `XMEMO_AGENT_INSTANCE_ID` | `agent_instance_id` |
+| `XMEMO_BUCKET` | `bucket` |
+| `XMEMO_SCOPE` | `scope` |
+| `XMEMO_TIMEOUT_SECONDS` | `timeout_seconds` |
+| `XMEMO_PREFETCH_MAX_ITEMS` | `prefetch_max_items` |
+| `XMEMO_PREFETCH_MAX_TOKENS` | `prefetch_max_tokens` |
+
+## Tools
+
+### Default tools
+
+These tools are always available:
+
+| Tool | Description |
+|------|-------------|
+| `xmemo_recall_context` | Build a bounded, ranked context pack |
+| `xmemo_search` | Semantic search over XMemo memories |
+| `xmemo_remember` | Save a durable fact |
+| `xmemo_update_state` | Save active task / next action / blocker with TTL |
+
+### Optional workflow tools
+
+Set `enable_workflow_tools: true` in `xmemo.json` to expose:
+
+| Tool | Description |
+|------|-------------|
+| `xmemo_record_event` | Append a timeline event or milestone |
+| `xmemo_create_reminder` | Create a TODO / action item |
+| `xmemo_list_reminders` | List open or completed reminders |
+| `xmemo_complete_reminder` | Mark a reminder as completed |
+
+### Optional destructive tool
+
+Set `enable_destructive_tools: true` to expose:
+
+| Tool | Description |
+|------|-------------|
+| `xmemo_forget` | Delete a memory by exact id |
+
+## Privacy & security
+
+- API keys live in `$HERMES_HOME/.env`, never in `xmemo.json`.
+- `xmemo_forget` requires an exact memory id and is disabled by default.
+- Automatic timeline writes are disabled by default. When enabled, only high-signal turns (decisions, preferences, blockers, etc.) are recorded.
+- Built-in `memory` tool writes are mirrored to XMemo only when the provider is active.
+- Prefetch cache is isolated per session, so concurrent gateway sessions cannot cross-contaminate recall context.
+
+## Uninstall or disable
+
+To disable XMemo without removing files:
+
+```bash
+hermes config set memory.provider ""
+```
+
+To remove the plugin entirely:
+
+```bash
+rm -rf "${HERMES_HOME:-$HOME/.hermes}/plugins/xmemo"
+```
+
+## Learn more
+
+- [xmemo.dev](https://xmemo.dev) — XMemo home
+- [Hermes Agent docs: Memory Providers](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers)
+
+## License
+
+MIT

hermes_xmemo-1.0.0/install-remote.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# One-liner installer for the XMemo Hermes memory provider plugin.
+# Downloads the latest plugin source from GitHub and runs the local install.sh.
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/yonro/hermes-xmemo-plugin/main/install-remote.sh | bash
+
+REPO_URL="https://github.com/yonro/hermes-xmemo-plugin.git"
+TMP_DIR="$(mktemp -d)"
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+echo "Downloading XMemo Hermes plugin..."
+git clone --depth 1 "$REPO_URL" "$TMP_DIR/hermes-xmemo-plugin"
+
+cd "$TMP_DIR/hermes-xmemo-plugin"
+bash install.sh

hermes_xmemo-1.0.0/install.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# Install the XMemo memory provider plugin into $HERMES_HOME/plugins/xmemo
+
+set -euo pipefail
+
+HERMES_HOME_ORIGINAL="${HERMES_HOME:-}"
+HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"
+DEST="$HERMES_HOME/plugins/xmemo"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Prefer the plugin files inside the pip package layout if it exists.
+if [ -d "$SCRIPT_DIR/src/hermes_xmemo/xmemo" ]; then
+    SRC="$SCRIPT_DIR/src/hermes_xmemo/xmemo"
+elif [ -d "$SCRIPT_DIR/xmemo" ]; then
+    SRC="$SCRIPT_DIR/xmemo"
+else
+    echo "Error: plugin source directory not found" >&2
+    echo "Run this script from the root of the hermes-xmemo-plugin repo." >&2
+    exit 1
+fi
+
+# Warn when running under WSL without an explicit HERMES_HOME, because the
+# default $HOME/.hermes may point to the WSL filesystem rather than the
+# Windows Hermes home that the user actually uses.
+if [ -z "$HERMES_HOME_ORIGINAL" ] && [ -n "${WSL_DISTRO_NAME:-}" ]; then
+    echo "Warning: WSL detected and HERMES_HOME is not set." >&2
+    echo "  Default install location: $DEST" >&2
+    echo "  If your Windows Hermes home is elsewhere, set HERMES_HOME and re-run." >&2
+fi
+
+echo "Installing XMemo memory provider plugin to $DEST"
+
+# Ensure the parent plugins directory exists before copying.
+mkdir -p "$(dirname "$DEST")"
+
+# Atomic-ish replacement: build in a temp directory, then swap.
+DEST_TMP="${DEST}.tmp.$$"
+rm -rf "$DEST_TMP"
+cp -a "$SRC" "$DEST_TMP"
+
+# Remove old install (including hidden files) and swap in the new one.
+rm -rf "$DEST"
+mv "$DEST_TMP" "$DEST"
+
+if [ ! -f "$DEST/__init__.py" ]; then
+    echo "Error: installation appears incomplete ($DEST/__init__.py missing)" >&2
+    exit 1
+fi
+
+echo "Installed to $DEST"
+echo "Run 'hermes memory setup xmemo' to configure."

hermes_xmemo-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=61.0", "setuptools_scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hermes-xmemo"
+dynamic = ["version"]
+description = "XMemo memory provider plugin for Hermes Agent"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    {name = "XMemo"},
+]
+keywords = ["hermes", "agent", "memory", "xmemo", "plugin"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "httpx>=0.25.0",
+]
+
+[project.scripts]
+hermes-xmemo = "hermes_xmemo.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/yonro/hermes-xmemo-plugin"
+Repository = "https://github.com/yonro/hermes-xmemo-plugin"
+Issues = "https://github.com/yonro/hermes-xmemo-plugin/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+hermes_xmemo = ["xmemo/*", "xmemo/**/*"]
+
+[tool.setuptools_scm]
+write_to = "src/hermes_xmemo/_version.py"
+fallback_version = "0.0.0+unknown"

hermes_xmemo-1.0.0/setup.cfg

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

hermes_xmemo-1.0.0/src/hermes_xmemo/__init__.py

@@ -0,0 +1,19 @@
+"""XMemo Hermes memory provider — pip-installable package.
+
+This package does not run inside Hermes directly.  It ships the plugin files
+and provides a small CLI that copies them into the user's Hermes plugins
+directory, which is the only location Hermes scans for memory providers.
+"""
+
+from __future__ import annotations
+
+try:
+    from importlib.metadata import version
+    __version__ = version("hermes-xmemo")
+except Exception:  # pragma: no cover
+    try:
+        from hermes_xmemo._version import __version__
+    except Exception:
+        __version__ = "unknown"
+
+__all__ = ["__version__"]

hermes_xmemo-1.0.0/src/hermes_xmemo/__main__.py

@@ -0,0 +1,10 @@
+"""Allow ``python -m hermes_xmemo install``."""
+
+from __future__ import annotations
+
+import sys
+
+from hermes_xmemo.install import main
+
+if __name__ == "__main__":
+    sys.exit(main())

hermes_xmemo-1.0.0/src/hermes_xmemo/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = 'g1ef689d12'

hermes_xmemo-1.0.0/src/hermes_xmemo/cli.py

@@ -0,0 +1,7 @@
+"""CLI entry point for the ``hermes-xmemo`` command."""
+
+from __future__ import annotations
+
+from hermes_xmemo.install import main
+
+__all__ = ["main"]