Epitome Personal Portable AI Memory Vault

Epitome

ひとつのメモリレイヤーで、すべての AI エージェントに。

あらゆる AI エージェントで共有できる、あなたについての永続的なメモリを提供するポータブルなアイデンティティレイヤーです。
オープンソース。セルフホスト可能。あなたのものです。

ウェブサイト · クイックスタート · エージェントを接続 · ドキュメント · コントリビュート

---

課題

AI との会話は毎回ゼロから始まります。名前、好み、アレルギー、技術スタックなど、どのエージェントにも同じことを伝え直す必要があります。チャット履歴はアプリごとに分断されています。ポータブルなメモリレイヤーはありません。

Epitome がこの問題を解決します。 すべての AI エージェントが共有するひとつのデータベースによって、どのエージェントもあなたを覚えていられます。

---

クイックスタート

ホスト版（最速）

1. epitome.fyi でサインアップします
2. Settings → API Keys に移動して、MCP URL をコピーします
3. 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 エージェントを接続

ダッシュボード（ホスト版またはセルフホスト版）の Settings → API Keys から 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 開発者
• さまざまなプラットフォームで、すべての AI に自分を覚えていてほしいパワーユーザー
• クラウドを使わずにデータを完全に所有したいセルフホストユーザー

ユースケース

• 食事記録エージェントがアレルギーを覚えている
• コーディングアシスタントが技術スタック、パターン、チームについて把握している
• カレンダーエージェントが家族、優先事項、日課について把握している
• 新しい AI ツールを試すとき、初日からすでにあなたのことを知っている

---

Epitome が選ばれる理由

	チャット履歴	ベクトル DB	ノートアプリ	Epitome
ポータブルなアイデンティティ				✓
複数エージェントで共有するメモリ				✓
ナレッジグラフ				✓
エージェントごとの同意と監査				✓
ユーザーごとのスキーマ分離				✓
構造化データ＋セマンティックデータ		一部対応		✓
セルフホスト可能		✓		✓

---

5 つのレイヤー

#	レイヤー	説明
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