Epitome

官方

个人AI记忆——为每个AI代理提供关于你的共享、持久记忆

GitHub

你可以用 Epitome MCP 做什么？

回忆你的AI助手了解你的哪些信息 — 让助手使用 recall 工具检索已存储的事实、偏好或上下文。
将新信息保存到共享记忆中 — 告诉助手通过 memorize 工具持久化你的偏好、事实或细节。
审查和审计已存储的记忆 — 使用 review 工具请求查看已保存内容的摘要或检查哪些代理访问过这些信息。

文档

Epitome

一个记忆层，适用于每一个 AI 代理。

可移植的身份层，为每一个 AI 代理提供共享、持久化的关于你的记忆。
开源。可自托管。属于你。

网站 · 快速入门 · 连接代理 · 文档 · 贡献

问题所在

每一次 AI 对话都从零开始。你向每一个代理重复自己——你的名字、你的偏好、你的过敏史、你的技术栈。聊天记录按应用隔离。没有可移植的记忆层。

Epitome 解决了这个问题。 一个所有 AI 代理共享的数据库，让它们都能记住你。

快速入门

托管版（最快）

在 epitome.fyi 注册
前往 设置 → API 密钥 并复制你的 MCP URL
连接一个 AI 代理 —— 完成

自托管

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 登录。

连接 AI 代理

从仪表板（托管版或自托管版）的 设置 → 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。请参阅完整工具参考。

适用人群

AI 开发者 构建需要持久化用户记忆的代理
高级用户 希望每个 AI 都能跨平台记住自己
自托管用户 希望完全拥有数据——无需云端

使用场景

你的饮食追踪代理记住你的过敏史
你的编程助手了解你的技术栈、编码模式和团队
你的日历代理了解你的家人、优先级和日常习惯
你尝试的每一个新 AI 工具从第一天起就了解你

为什么选择 Epitome？

	向量数据库	Epitome
可移植身份		✓
多代理共享记忆		✓
知识图谱		✓
按代理的同意与审计		✓
按用户模式隔离		✓
结构化 + 语义数据	部分	✓
可自托管	✓	✓

五个层次

#	层次	描述
01	个人数据库	结构化表、向量语义记忆和键值存储。你的数据存在于 PostgreSQL 中——可查询、可导出、属于你。
02	可移植身份	任何 AI 代理都能即时读取的结构化档案。姓名、偏好、关系——零冷启动，贯穿每一次对话。
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