Epitome

officiel

Mémoire AI personnelle — donne à chaque agent AI une mémoire partagée et persistante de vous.

GitHub

Que pouvez-vous faire avec 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.

Documentation

Epitome

Une couche mémoire unique, pour chaque agent IA.

La couche d’identité portable qui donne à chaque agent IA une mémoire partagée et persistante de vous.
Open source. Auto-hébergeable. À vous.

Site Web · Démarrage rapide · Connecter un agent · Documentation · Contribuer

Le Problème

Chaque conversation avec une IA repart de zéro. Vous vous répétez pour chaque agent — votre nom, vos préférences, vos allergies, votre stack technique. L’historique des discussions est cloisonné par application. Il n’existe pas de couche mémoire portable.

Epitome résout ce problème. Une base de données unique partagée par tous les agents IA, pour qu’ils se souviennent tous de vous.

Démarrage rapide

Hébergé (le plus rapide)

Inscrivez-vous sur epitome.fyi
Allez dans Paramètres → Clés API et copiez votre URL MCP
Connectez un agent IA — terminé

Auto-hébergé

git clone https://github.com/gunning4it/epitome.git
cd epitome
cp .env.example .env    # edit with your credentials
docker compose up -d

Ouvrez localhost:5173 et connectez-vous avec Google ou GitHub OAuth.

Connecter un agent IA

Obtenez votre clé API depuis Paramètres → Clés API dans le tableau de bord (hébergé ou auto-hébergé).

Claude Desktop

Ajoutez à votre 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

Auto-hébergé

Pour l’auto-hébergement, remplacez https://epitome.fyi par http://localhost:3000.

Epitome expose 3 outils MCP — recall, memorize et review. Consultez la référence complète des outils.

À qui cela s’adresse

Développeurs IA construisant des agents qui ont besoin d’une mémoire utilisateur persistante
Utilisateurs avancés qui veulent que chaque IA se souvienne d’eux à travers les plateformes
Auto-hébergeurs qui veulent la pleine propriété de leurs données — sans cloud requis

Cas d’usage

Votre agent de suivi de repas se souvient de vos allergies
Votre assistant de codage connaît votre stack, vos habitudes, votre équipe
Votre agent d’agenda connaît votre famille, vos priorités, vos routines
Chaque nouvel outil IA que vous essayez vous connaît déjà dès le premier jour

Pourquoi Epitome ?

	Base vectorielle	Epitome
Identité portable		✓
Mémoire partagée multi-agents		✓
Graphe de connaissances		✓
Consentement et audit par agent		✓
Isolation de schéma par utilisateur		✓
Données structurées + sémantiques	partiel	✓
Auto-hébergeable	✓	✓

Les Cinq Couches

#	Couche	Description
01	Base de données personnelle	Tables structurées, mémoire sémantique vectorielle et stockage clé-valeur. Vos données résident dans PostgreSQL — interrogeables, exportables, à vous.
02	Identité portable	Un profil structuré que tout agent IA lit instantanément. Nom, préférences, relations — zéro départ à froid, à chaque conversation.
03	Qualité de la mémoire	Score de confiance, attribution de la source et gestion du cycle de vie. Les souvenirs gagnent en confiance par renforcement, pas par foi aveugle.
04	Graphe de connaissances	Entités avec des arêtes typées et pondérées. Personnes, lieux, concepts — connectés dans un graphe qui s’enrichit à chaque interaction.
05	Consentement et audit	Permissions par table et journal d’activité en ajout seul. Vous contrôlez exactement ce que chaque agent peut voir et faire.

Architecture

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

Chaque utilisateur obtient son propre schéma PostgreSQL (user_{id}) — pas de sécurité au niveau des lignes, une isolation complète au niveau du schéma. L’accès inter-schéma est impossible au niveau SQL.

Consultez EPITOME_TECH_SPEC.md pour l’architecture complète.

Sécurité et confidentialité

Vous possédez vos données — auto-hébergez ou utilisez le service hébergé
Isolation par schéma PostgreSQL par utilisateur — pas de sécurité au niveau des lignes, séparation complète des schémas
Règles de consentement par agent — vous contrôlez ce que chaque agent peut lire et écrire
Journal d’audit en ajout seul — chaque accès est enregistré
Prêt pour le RGPD — exportez ou supprimez toutes vos données à tout moment

Stack technique

Composant	Technologie
Runtime	Node.js 22 LTS
API	Hono
Base de données	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
Frontend	React 19 + Tailwind CSS 4 + shadcn/ui
Validation	Zod
Tests	Vitest

Documentation

Démarrage rapide — Fonctionnel en quelques minutes
SDK JavaScript — Construisez avec @epitomefyi/sdk
Paquet npm — Installation et historique des versions
Outils SDK IA — searchMemory, saveMemory, getUserContext pour l’appel d’outils
Référence API — Documentation des points de terminaison REST
Outils MCP — Les 3 outils MCP expliqués
Architecture — Spécification technique complète
Modèle de données — Chaque table, colonne et contrainte
Guide d’auto-hébergement — Déploiement avec Docker Compose
Sécurité — Isolation, consentement et audit

Contribuer

Les contributions sont les bienvenues ! Consultez CONTRIBUTING.md pour les directives.

git clone https://github.com/gunning4it/epitome.git
cd epitome && cp .env.example .env
docker compose up -d

Ensuite, ouvrez une PR — nous sommes ravis de vous aider pour votre première contribution.

Licence

MIT