Hippocampus

Персональная память в виде графа с интерфейсом HTTP + MCP, замена Obsidian/Engram.

Стек: uv · Python 3.11+ · SQLModel + SQLite (FTS5) · FastAPI + FastMCP · Typer · Rich.

Запуск

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

Подкоманды: init, serve, mcp (stdio), graph (интерактивная карта в HTML, --tui для табличного представления), backup (дамп SQL).

Related MCP server: 2BToRePensieve

Архитектура

Чистая архитектура по слоям (зависимости → внутрь):

• api/ — HTTP/MCP-транспорт (ноль логики).

• schemas/ — API-контракт (Pydantic, D26).

• core/ — Домен (поиск-и-связывание, граф, техническая часть).

• db/, models/ — Персистентность (SQLModel, FTS5, seed).

Два изолированных по построению пространства (без колонки space):

1. Личное (граф): узлы → рёбра → документы + вложения. Заменяет Obsidian.

2. Техническое (в стиле Engram): observations с status/type. Заменяет Engram.

Подробности — в docs/sdd-hippocampus.md (полный SDD) и docs/todo-hippocampus.md (чек-лист).

Документация

• docs/architecture.md — принципы и структура.

• docs/data-model.md — ER-схема (8 таблиц + FTS).

• docs/core-services.md — доменные сервисы (поиск-и-связывание).

• docs/http-mcp-api.md — транспорт (15 инструментов).

• docs/e2e-flows.md — реальные проверенные сценарии.

• docs/startup-and-init.md — запуск + NO_INIT.

• docs/runtime-launchd.md — автозапуск в сессии.

• docs/workspace-rewiring.md — интеграция с psychologist.

Спецификации (приватные)

• docs/specs/sdd-hippocampus.md — детальное проектирование (решения D1–D26, требования R1–R13).

• docs/specs/todo-hippocampus.md — чек-лист реализации (Фаза 0 завершена).

• docs/specs/sdd-obsidian-migration.md — детерминированный мигратор Obsidian→hippocampus.