Hippocampus

Persönliches Gedächtnis als Graph mit HTTP + MCP-Schnittstelle, Ersatz für Obsidian/Engram.

Stack: uv · Python 3.11+ · SQLModel + SQLite (FTS5) · FastAPI + FastMCP · Typer · Rich.

Start

uv sync                           # OBLIGATORIO
uv run hippocampus init <db-path> # bootstrap (crea BD + siembra)
uv run hippocampus serve          # HTTP+MCP en 127.0.0.1:27130

Unterbefehle: init, serve, mcp (stdio), graph (interaktive Karte in HTML, --tui für die Tabellenansicht), backup (SQL-Dump).

Related MCP server: 2BToRePensieve

Architektur

Clean Architecture in Schichten (Abhängigkeiten → nach innen):

• api/ — HTTP/MCP-Transport (null Logik).

• schemas/ — API-Vertrag (Pydantic, D26).

• core/ — Domäne (búsqueda-y-enlazar, Graph, Technik).

• db/, models/ — Persistenz (SQLModel, FTS5, Seed).

Zwei durch Konstruktion getrennte Bereiche (ohne space-Spalte):

1. Persönlich (Graph): Knoten → edges → documents + attachments. Ersetzt Obsidian.

2. Technisch (Engram-style): observations mit status/type. Ersetzt Engram.

Siehe docs/sdd-hippocampus.md (vollständiges SDD) und docs/todo-hippocampus.md (Checkliste) für Details.

Dokumentation

• docs/architecture.md — Prinzipien und Struktur.

• docs/data-model.md — ER-Schema (8 Tabellen + FTS).

• docs/core-services.md — Domänendienste (búsqueda-y-enlazar).

• docs/http-mcp-api.md — Transport (15 Tools).

• docs/e2e-flows.md — reale verifizierte Abläufe.

• docs/startup-and-init.md — Start + NO_INIT.

• docs/runtime-launchd.md — Autostart in der Sitzung.

• docs/workspace-rewiring.md — Integration mit psychologist.

Spezifikationen (privat)

• docs/specs/sdd-hippocampus.md — detailliertes Design (Entscheidungen D1–D26, Anforderungen R1–R13).

• docs/specs/todo-hippocampus.md — Implementierungs-Checkliste (Phase 0 abgeschlossen).

• docs/specs/sdd-obsidian-migration.md — deterministischer Obsidian→hippocampus-Migrator.