Epitome

oficial

Memoria personal de IA — le da a cada agente de IA una memoria compartida y persistente de ti

GitHub

¿Qué puedes hacer con Epitome MCP?

Recuerda lo que tu asistente de IA sabe sobre ti — pídele al asistente que recupere hechos, preferencias o contexto almacenados usando la herramienta recall.
Guarda nueva información en tu memoria compartida — indícale al asistente que persista una preferencia, hecho o detalle sobre ti mediante la herramienta memorize.
Revisa y audita los recuerdos almacenados — solicita un resumen o inspección de lo que se ha guardado y qué agentes han accedido a ello usando la herramienta review.

Documentación

Epitome

Una capa de memoria, cada agente de IA.

La capa de identidad portátil que le da a cada agente de IA una memoria compartida y persistente sobre ti.
Código abierto. Autoalojable. Tuyo.

Sitio web · Inicio rápido · Conectar un agente · Documentos · Contribuir

El problema

Cada conversación con IA empieza desde cero. Te repites ante cada agente: tu nombre, tus preferencias, tus alergias, tu stack tecnológico. El historial de chat está aislado por aplicación. No hay una capa de memoria portátil.

Epitome lo soluciona. Una base de datos que todos los agentes de IA comparten, para que todos te recuerden.

Inicio rápido

Alojado (lo más rápido)

Regístrate en epitome.fyi
Ve a Configuración → Claves API y copia tu URL MCP
Conecta un agente de IA — listo

Autoalojado

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

Abre localhost:5173 e inicia sesión con OAuth de Google o GitHub.

Conectar un agente de IA

Obtén tu clave API desde Configuración → Claves API en el panel (alojado o autoalojado).

Claude Desktop

Añade a tu 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

Autoalojado

Para autoalojado, reemplaza https://epitome.fyi con http://localhost:3000.

Epitome expone 3 herramientas MCP: recordar, memorizar y revisar. Consulta la referencia completa de herramientas.

Para quién es esto

Desarrolladores de IA que construyen agentes que necesitan memoria de usuario persistente
Usuarios avanzados que quieren que cada IA los recuerde en todas las plataformas
Autoalojadores que quieren propiedad total de los datos — sin necesidad de nube

Casos de uso

Tu agente de seguimiento de comidas recuerda tus alergias
Tu asistente de codificación conoce tu stack, tus patrones, tu equipo
Tu agente de calendario conoce a tu familia, tus prioridades, tus rutinas
Cada nueva herramienta de IA que pruebas ya te conoce desde el primer día

¿Por qué Epitome?

	BD vectorial	Epitome
Identidad portátil		✓
Memoria compartida multiagente		✓
Grafo de conocimiento		✓
Consentimiento y auditoría por agente		✓
Aislamiento de esquema por usuario		✓
Datos estructurados + semánticos	parcial	✓
Autoalojable	✓	✓

Las cinco capas

#	Capa	Descripción
01	Base de datos personal	Tablas estructuradas, memoria semántica vectorial y almacenamiento clave-valor. Tus datos residen en PostgreSQL: consultables, exportables, tuyos.
02	Identidad portátil	Un perfil estructurado que cualquier agente de IA lee al instante. Nombre, preferencias, relaciones: cero arranque en frío, en cada conversación.
03	Calidad de la memoria	Puntuación de confianza, atribución de fuente y gestión del ciclo de vida. Los recuerdos ganan confianza mediante refuerzo, no por fe ciega.
04	Grafo de conocimiento	Entidades con aristas tipadas y ponderadas. Personas, lugares, conceptos: conectados en un grafo que crece con cada interacción.
05	Consentimiento y auditoría	Permisos por tabla y un registro de actividad de solo anexión. Tú controlas exactamente lo que cada agente puede ver y hacer.

Arquitectura

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

Cada usuario obtiene su propio esquema de PostgreSQL (user_{id}) — no es seguridad a nivel de fila, es aislamiento completo a nivel de esquema. El acceso entre esquemas es imposible a nivel SQL.

Consulta EPITOME_TECH_SPEC.md para la arquitectura completa.

Seguridad y privacidad

Tú eres dueño de tus datos — autoalójalo o usa el servicio alojado
Aislamiento de esquema PostgreSQL por usuario — no es seguridad a nivel de fila, es separación completa de esquemas
Reglas de consentimiento por agente — tú controlas lo que cada agente puede leer y escribir
Registro de auditoría de solo anexión — cada acceso queda registrado
Preparado para GDPR — exporta o elimina todos tus datos en cualquier momento

Stack tecnológico

Componente	Tecnología
Runtime	Node.js 22 LTS
API	Hono
Base de datos	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
Frontend	React 19 + Tailwind CSS 4 + shadcn/ui
Validación	Zod
Pruebas	Vitest

Documentación

Inicio rápido — Ponte en marcha en minutos
SDK de JavaScript — Construye con @epitomefyi/sdk
Paquete npm — Instalación e historial de versiones
Herramientas del SDK de IA — searchMemory, saveMemory, getUserContext para llamada de herramientas
Referencia de la API — Documentación de endpoints REST
Herramientas MCP — Las 3 herramientas MCP explicadas
Arquitectura — Especificación técnica completa
Modelo de datos — Cada tabla, columna y restricción
Guía de autoalojamiento — Despliegue con Docker Compose
Seguridad — Aislamiento, consentimiento y auditoría

Contribuir

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para las pautas.

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

Luego abre un PR — estaremos encantados de ayudarte con tu primera contribución.

Licencia

MIT