Epitome

官方

個人AI記憶——為每個AI代理提供關於你的共享、持久記憶

GitHub

你可以用 Epitome MCP 做什麼？

Recall what your AI assistant knows about you — ask the assistant to retrieve stored facts, preferences, or context using the recall tool.
Save new information to your shared memory — tell the assistant to persist a preference, fact, or detail about you via the memorize tool.
Review and audit stored memories — request a summary or inspection of what’s been saved and which agents have accessed it using the review tool.

文件

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