{
  "markdown": "<p align=\"center\">\n  <img src=\"dashboard/public/epitome.png\" alt=\"Epitome\" width=\"80\" />\n</p>\n\n<h1 align=\"center\">Epitome</h1>\n\n<p align=\"center\">\n  <strong>One memory layer, every AI agent.</strong>\n</p>\n\n<p align=\"center\">\n  The portable identity layer that gives every AI agent a shared, persistent memory of you.<br />\n  Open source. Self-hostable. Yours.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/gunning4it/epitome/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/gunning4it/epitome\" alt=\"MIT License\" /></a>\n  <a href=\"https://github.com/gunning4it/epitome/stargazers\"><img src=\"https://img.shields.io/github/stars/gunning4it/epitome\" alt=\"GitHub Stars\" /></a>\n  <a href=\"https://github.com/gunning4it/epitome/actions\"><img src=\"https://img.shields.io/github/actions/workflow/status/gunning4it/epitome/ci.yml?branch=main&label=tests\" alt=\"Tests\" /></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://epitome.fyi\">Website</a> ·\n  <a href=\"#quickstart\">Quickstart</a> ·\n  <a href=\"#connect-an-ai-agent\">Connect an Agent</a> ·\n  <a href=\"https://epitome.fyi/docs\">Docs</a> ·\n  <a href=\"#contributing\">Contributing</a>\n</p>\n\n---\n\n## The Problem\n\nEvery AI conversation starts from zero. You repeat yourself to every agent — your name, your preferences, your allergies, your tech stack. Chat history is siloed per app. There's no portable memory layer.\n\n**Epitome fixes this.** One database that every AI agent shares, so they all remember you.\n\n---\n\n## Quickstart\n\n### Hosted (fastest)\n\n1. Sign up at [epitome.fyi](https://epitome.fyi)\n2. Go to **Settings → API Keys** and copy your MCP URL\n3. [Connect an AI agent](#connect-an-ai-agent) — done\n\n### Self-Hosted\n\n```bash\ngit clone https://github.com/gunning4it/epitome.git\ncd epitome\ncp .env.example .env    # edit with your credentials\ndocker compose up -d\n```\n\nOpen [localhost:5173](http://localhost:5173) and sign in with Google or GitHub OAuth.\n\n---\n\n## Connect an AI Agent\n\nGet your API key from **Settings → API Keys** in the dashboard (hosted or self-hosted).\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"epitome\": {\n      \"url\": \"https://epitome.fyi/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http --header \"Authorization: Bearer YOUR_API_KEY\" epitome https://epitome.fyi/mcp\n```\n\n### Self-Hosted\n\nFor self-hosted, replace `https://epitome.fyi` with `http://localhost:3000`.\n\nEpitome exposes **3 MCP tools** — recall, memorize, and review. See the [full tool reference](https://epitome.fyi/docs/mcp-tools).\n\n---\n\n## Who This Is For\n\n- **AI developers** building agents that need persistent user memory\n- **Power users** who want every AI to remember them across platforms\n- **Self-hosters** who want full data ownership — no cloud required\n\n### Use Cases\n\n- Your meal-tracking agent remembers your allergies\n- Your coding assistant knows your stack, your patterns, your team\n- Your calendar agent knows your family, your priorities, your routines\n- Every new AI tool you try already knows you on day one\n\n---\n\n## Why Epitome?\n\n|  | Chat History | Vector DB | Note Apps | **Epitome** |\n|---|:---:|:---:|:---:|:---:|\n| Portable identity | | | | **✓** |\n| Multi-agent shared memory | | | | **✓** |\n| Knowledge graph | | | | **✓** |\n| Consent & audit per agent | | | | **✓** |\n| Per-user schema isolation | | | | **✓** |\n| Structured + semantic data | | partial | | **✓** |\n| Self-hostable | | ✓ | | **✓** |\n\n---\n\n## The Five Layers\n\n| # | Layer | Description |\n|---|-------|-------------|\n| 01 | **Personal Database** | Structured tables, vector semantic memory, and key-value storage. Your data lives in PostgreSQL — queryable, exportable, yours. |\n| 02 | **Portable Identity** | A structured profile any AI agent reads instantly. Name, preferences, relationships — zero cold start, every conversation. |\n| 03 | **Memory Quality** | Confidence scoring, source attribution, and lifecycle management. Memories earn trust through reinforcement, not blind faith. |\n| 04 | **Knowledge Graph** | Entities with typed, weighted edges. People, places, concepts — connected in a graph that grows with every interaction. |\n| 05 | **Consent & Audit** | Per-table permissions and an append-only activity log. You control exactly what each agent can see and do. |\n\n---\n\n## Architecture\n\n```\nAI Agent ──→ MCP (Streamable HTTP) ──→ Hono API ──→ PostgreSQL\n                                         │\n                                    per-user schema\n                                      isolation\n```\n\nEach user gets their own PostgreSQL schema (`user_{id}`) — not row-level security, full schema-level isolation. Cross-schema access is impossible at the SQL level.\n\nSee [EPITOME_TECH_SPEC.md](EPITOME_TECH_SPEC.md) for the full architecture.\n\n---\n\n## Security & Privacy\n\n- **You own your data** — self-host or use the hosted service\n- **Per-user PostgreSQL schema isolation** — not row-level security, full schema separation\n- **Per-agent consent rules** — you control what each agent can read and write\n- **Append-only audit log** — every access is recorded\n- **GDPR-ready** — export or delete all your data at any time\n\n---\n\n## Tech Stack\n\n| Component | Technology |\n|-----------|-----------|\n| Runtime | Node.js 22 LTS |\n| API | Hono |\n| Database | PostgreSQL 17 + pgvector |\n| MCP | @modelcontextprotocol/sdk |\n| Frontend | React 19 + Tailwind CSS 4 + shadcn/ui |\n| Validation | Zod |\n| Testing | Vitest |\n\n---\n\n## Documentation\n\n- [Quick Start](https://epitome.fyi/docs/quick-start) — Get running in minutes\n- [JavaScript SDK](https://epitome.fyi/docs/javascript-sdk) — Build with `@epitomefyi/sdk`\n- [npm Package](https://www.npmjs.com/package/@epitomefyi/sdk) — Install and version history\n- [AI SDK Tools](https://epitome.fyi/docs/javascript-sdk-ai-tools) — `searchMemory`, `saveMemory`, `getUserContext` for tool-calling\n- [API Reference](https://epitome.fyi/docs/api-reference) — REST endpoint documentation\n- [MCP Tools](https://epitome.fyi/docs/mcp-tools) — All 3 MCP tools explained\n- [Architecture](EPITOME_TECH_SPEC.md) — Full technical specification\n- [Data Model](EPITOME_DATA_MODEL.md) — Every table, column, and constraint\n- [Self-Hosting Guide](https://epitome.fyi/docs/self-hosting) — Docker Compose deployment\n- [Security](https://epitome.fyi/docs/security) — Isolation, consent, and audit\n\n---\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n```bash\ngit clone https://github.com/gunning4it/epitome.git\ncd epitome && cp .env.example .env\ndocker compose up -d\n```\n\nThen open a PR — we're happy to help with your first contribution.\n\n---\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 6770,
  "sha": "b950d7c93cb4e1cb3a974121e4597d7f252df04cfbbe48647970be42d8ad5c77",
  "repo_slug": "gunning4it/epitome",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gunning4it_epitome_mcp_1233c15a/readme"
}