Epitome Personal Portable AI Memory Vault

Epitome

一层记忆，服务每个 AI Agent。

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

网站 · 快速开始 · 连接 Agent · 文档 · 参与贡献

---

问题所在

每次 AI 对话都从零开始。你得向每个 Agent 重复介绍自己——你的名字、偏好、过敏情况、技术栈。聊天记录在各个应用中彼此隔离。没有可移植的记忆层。

Epitome 解决了这个问题。 一个数据库供每个 AI Agent 共享，让它们都能记住你。

---

快速开始

托管版（最快）

1. 在 epitome.fyi 注册
2. 前往 设置 → API 密钥，复制 MCP URL
3. 连接 AI Agent——完成

自托管

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 Agent

在仪表板的 设置 → 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 工具——回忆、记忆和审查。请参阅完整工具参考。

---

适用人群

• AI 开发者：构建需要持久用户记忆的 Agent
• 高级用户：希望各个平台上的 AI 都能记住自己
• 自托管用户：希望完全掌控数据，无需云服务

使用场景

• 你的膳食追踪 Agent 会记住你的过敏情况
• 你的编码助手了解你的技术栈、习惯和团队
• 你的日历 Agent 了解你的家人、优先事项和日常安排
• 你尝试的每个新 AI 工具从第一天起就了解你

---

为什么选择 Epitome？

	聊天记录	向量数据库	笔记应用	Epitome
可移植身份				✓
多 Agent 共享记忆				✓
知识图谱				✓
针对每个 Agent 的授权与审计				✓
按用户隔离架构				✓
结构化数据 + 语义数据		部分支持		✓
可自托管		✓		✓

---

五个层次

#	层次	描述
01	个人数据库	结构化表、向量语义记忆和键值存储。你的数据存放在 PostgreSQL 中，可查询、可导出，归你所有。
02	可移植身份	每个 AI Agent 都能即时读取的结构化档案。姓名、偏好、人际关系——每次对话都无需从零开始。
03	记忆质量	置信度评分、来源归属和生命周期管理。记忆通过反复验证赢得信任，而非盲目信赖。
04	知识图谱	带类型和权重的实体关系。人物、地点、概念——在图谱中相互关联，并随每次互动不断扩展。
05	授权与审计	按表设置权限，并提供只追加的活动日志。你可以精确控制每个 Agent 能查看和执行的操作。

---

架构

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

每位用户都有自己的 PostgreSQL 架构（user_{id}）——不是行级安全，而是完整的架构级隔离。在 SQL 层面无法跨架构访问。

完整架构请参阅 EPITOME_TECH_SPEC.md。

---

安全与隐私

• 数据由你掌控——自行托管或使用托管服务
• 按用户隔离 PostgreSQL 架构——不是行级安全，而是完整的架构隔离
• 按 Agent 设置同意规则——你可以控制每个 Agent 能读取和写入的内容
• 仅追加审计日志——记录每一次访问
• 符合 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