undermybelt 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_BINHERMES_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.