Epitome

Epitome

Один слой памяти для каждого ИИ-агента.

Переносимый слой идентичности, который дает каждому ИИ-агенту общую, постоянную память о вас.
Открытый исходный код. Возможность самостоятельного хостинга. Ваше.

Веб-сайт · Быстрый старт · Подключить агента · Документация · Участие в разработке

---

Проблема

Каждый разговор с ИИ начинается с нуля. Вы повторяетесь каждому агенту — ваше имя, ваши предпочтения, ваши аллергии, ваш технологический стек. История чатов разрознена по приложениям. Нет переносимого слоя памяти.

Epitome исправляет это. Одна база данных, которую разделяют все ИИ-агенты, чтобы все они помнили вас.

---

Быстрый старт

Хостинг (самый быстрый)

1. Зарегистрируйтесь на epitome.fyi
2. Перейдите в Настройки → API-ключи и скопируйте ваш MCP URL
3. Подключите ИИ-агента — готово

Самостоятельный хостинг

git clone https://github.com/gunning4it/epitome.git
cd epitome
cp .env.example .env    # edit with your credentials
docker compose up -d

Откройте localhost:5173 и войдите через Google или GitHub OAuth.

---

Подключение ИИ-агента

Получите ваш API-ключ в разделе Настройки → API-ключи в панели управления (хостинг или самостоятельный).

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "epitome": {
      "url": "https://epitome.fyi/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" epitome https://epitome.fyi/mcp

Самостоятельный хостинг

Для самостоятельного хостинга замените https://epitome.fyi на http://localhost:3000.

Epitome предоставляет 3 инструмента MCP — recall, memorize и review. См. полную справку по инструментам.

---

Для кого это

• Разработчики ИИ, создающие агентов, которым нужна постоянная память о пользователе
• Опытные пользователи, которые хотят, чтобы каждый ИИ помнил их на разных платформах
• Самостоятельные хостеры, которые хотят полного владения данными — облако не требуется

Варианты использования

• Ваш агент отслеживания питания помнит о ваших аллергиях
• Ваш ассистент по кодингу знает ваш стек, ваши шаблоны, вашу команду
• Ваш агент календаря знает вашу семью, ваши приоритеты, ваш распорядок
• Каждый новый ИИ-инструмент, который вы пробуете, уже знает вас с первого дня

---

Почему Epitome?

	История чатов	Векторная БД	Приложения для заметок	Epitome
Переносимая идентичность				✓
Мультиагентная общая память				✓
Граф знаний				✓
Согласие и аудит для каждого агента				✓
Изоляция схемы для каждого пользователя				✓
Структурированные + семантические данные		частично		✓
Возможность самостоятельного хостинга		✓		✓

---

Пять слоев

#	Слой	Описание
01	Персональная база данных	Структурированные таблицы, векторная семантическая память и хранилище ключ-значение. Ваши данные живут в PostgreSQL — с возможностью запросов, экспорта, ваши.
02	Переносимая идентичность	Структурированный профиль, который любой ИИ-агент читает мгновенно. Имя, предпочтения, отношения — ноль холодного старта, каждый разговор.
03	Качество памяти	Оценка достоверности, указание источника и управление жизненным циклом. Воспоминания заслуживают доверие через подкрепление, а не слепую веру.
04	Граф знаний	Сущности с типизированными, взвешенными связями. Люди, места, концепции — связаны в графе, который растет с каждым взаимодействием.
05	Согласие и аудит	Разрешения на уровне таблиц и журнал активности только для добавления. Вы точно контролируете, что каждый агент может видеть и делать.

---

Архитектура

AI Agent ──→ MCP (Streamable HTTP) ──→ Hono API ──→ PostgreSQL
                                         │
                                    per-user schema
                                      isolation

Каждый пользователь получает свою собственную схему PostgreSQL (user_{id}) — не безопасность на уровне строк, а полная изоляция на уровне схемы. Межсхемный доступ невозможен на уровне SQL.

См. EPITOME_TECH_SPEC.md для полной архитектуры.

---

Безопасность и конфиденциальность

• Вы владеете своими данными — самостоятельный хостинг или использование облачного сервиса
• Изоляция схемы PostgreSQL для каждого пользователя — не безопасность на уровне строк, а полное разделение схем
• Правила согласия для каждого агента — вы контролируете, что каждый агент может читать и записывать
• Журнал аудита только для добавления — каждый доступ записывается
• Готовность к GDPR — экспортируйте или удалите все ваши данные в любое время

---

Технологический стек

Компонент	Технология
Среда выполнения	Node.js 22 LTS
API	Hono
База данных	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
Фронтенд	React 19 + Tailwind CSS 4 + shadcn/ui
Валидация	Zod
Тестирование	Vitest

---

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

• Быстрый старт — Запуск за минуты
• JavaScript SDK — Сборка с @epitomefyi/sdk
• Пакет npm — Установка и история версий
• Инструменты AI SDK — searchMemory, saveMemory, getUserContext для вызова инструментов
• Справка по API — Документация по конечным точкам REST
• Инструменты MCP — Объяснение всех 3 инструментов MCP
• Архитектура — Полная техническая спецификация
• Модель данных — Каждая таблица, столбец и ограничение
• Руководство по самостоятельному хостингу — Развертывание с Docker Compose
• Безопасность — Изоляция, согласие и аудит

---

Участие в разработке

Вклад приветствуется! См. CONTRIBUTING.md для руководства.

git clone https://github.com/gunning4it/epitome.git
cd epitome && cp .env.example .env
docker compose up -d

Затем откройте PR — мы будем рады помочь с вашим первым вкладом.

---

Лицензия

MIT