[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_107":108},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":11,"_65":49,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":-5,"_78":-5,"_79":49,"_80":-5,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","gunning4it","moduleId","epitome","@gunning4it/epitome","displayName","Epitome","tagline","Personal AI memory — gives every AI agent shared, persistent memory of you","iconKey","https://avatars.githubusercontent.com/u/16078473?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://epitome.fyi/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363440000,"updatedAt",1788780900000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.gunning4it%2Fepitome-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",8,"upstreamUpdatedAt",1779540709000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/gunning4it/epitome","githubRepoFullName","gunning4it/epitome","releaseId","ext-gunning4it-epitome","version","1.0.0","descriptionMarkdown","

\n $\"Epitome\"$ \n

\n\n

Epitome

\n\n

\n One memory layer, every AI agent.\n

\n\n

\n The portable identity layer that gives every AI agent a shared, persistent memory of you.
\n Open source. Self-hostable. Yours.\n

\n\n

\n $\"MIT$ \n $\"GitHub$ \n $\"Tests\"$ \n

\n\n

\n Website ·\n Quickstart ·\n Connect an Agent ·\n Docs ·\n Contributing\n

\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](https://github.com/gunning4it/epitome/blob/main/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](https://github.com/gunning4it/epitome/blob/main/EPITOME_TECH_SPEC.md) — Full technical specification\n- [Data Model](https://github.com/gunning4it/epitome/blob/main/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](https://github.com/gunning4it/epitome/blob/main/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](https://github.com/gunning4it/epitome/blob/main/LICENSE)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104,"_105":106},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":82,"_94":82},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","io.github.gunning4it/epitome-mcp","homepage","https://epitome.fyi","packages",[],"ENV",{"_109":110,"_111":112,"_113":114},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]