hypatia-bridge

name	hypatia-bridge
description	Use when Hermes needs a local external memory/knowledge-graph backend without remote services. Trigger when storing durable notes outside built-in memory, querying local knowledge shelves, syncing selected Hermes memory into a searchable graph, or building a fallback local memory layer.
tags	["memory","knowledge-graph","sqlite","duckdb","hypatia"]
version	1

Hypatia Bridge

Purpose

Use local Hypatia as a sidecar memory layer for Hermes.

When to use

• Need durable local notes beyond built-in memory limits
• Need searchable external memory
• Need subject/predicate/object graph facts
• Need a local fallback when hosted memory is not enough

Assets

Workspace:

• ~/Downloads/hermes-hacks/hermes-hypatia-bridge/

Primary CLI:

• python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py

Default Hypatia binary:

• ~/Downloads/repo-intake/hypatia/target/release/hypatia

Linked reference

• references/usage.md

Commands

Add note

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py add-note "Name" "Body" --tags a,b

Search

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py search "query"

Get note

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py get-note "Name"

Add statement

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py add-statement Hermes uses Hypatia --data "external memory backend"

Query triple

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py query-triple Hermes uses Hypatia

Raw JSE query

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py query '["$knowledge", ["$search", "persona"]]'

Selective Hermes sync

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_memory_sync.py add-memory user persona "Default terse Wenyan mode"
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_memory_sync.py add-fact Hermes uses Hypatia --data "external memory backend"

Semi-auto wrapper

python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_auto_sync.py memory user persona "Default terse Wenyan mode"
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_auto_sync.py fact Hermes uses Hypatia --data "external memory backend"
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_auto_sync.py memory memory long_term_rule "Prefer direct execution" --sync no

Environment

• HYPATIA_BIN
• HERMES_HYPATIA_SHELF

Pitfalls

• If search returns empty after writes, verify Hypatia binary is rebuilt with FTS rebuild fix in src/storage/sqlite_store.rs.
• Keep built-in Hermes memory for compact user prefs; use Hypatia for larger external recall.