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
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py add-note "Name" "Body" --tags a,b
```

### Search
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py search "query"
```

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

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

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

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

### Selective Hermes sync
```bash
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
```bash
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.