Epitome

oficial

Memória pessoal de IA — dá a cada agente de IA uma memória compartilhada e persistente de você

GitHub

Experimente este MCPPatrocinado

O que você pode fazer com Epitome MCP?

Lembre-se do que seu assistente de IA sabe sobre você — peça ao assistente para recuperar fatos, preferências ou contexto armazenados usando a ferramenta recall.
Salve novas informações na sua memória compartilhada — diga ao assistente para persistir uma preferência, fato ou detalhe sobre você por meio da ferramenta memorize.
Revise e audite memórias armazenadas — solicite um resumo ou inspeção do que foi salvo e quais agentes o acessaram usando a ferramenta review.

Documentação

Epitome

Uma camada de memória, todo agente de IA.

A camada de identidade portátil que dá a todo agente de IA uma memória compartilhada e persistente sobre você.
Código aberto. Auto-hospedável. Seu.

Website · Início Rápido · Conectar um Agente · Documentação · Contribuindo

O Problema

Toda conversa com IA começa do zero. Você se repete para cada agente — seu nome, suas preferências, suas alergias, sua stack de tecnologia. O histórico de conversas fica isolado por aplicativo. Não há uma camada de memória portátil.

Epitome resolve isso. Um banco de dados que todo agente de IA compartilha, para que todos se lembrem de você.

Início Rápido

Hospedado (mais rápido)

Cadastre-se em epitome.fyi
Vá para Configurações → Chaves de API e copie sua URL MCP
Conecte um agente de IA — pronto

Auto-Hospedado

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

Abra localhost:5173 e faça login com OAuth do Google ou GitHub.

Conectar um Agente de IA

Obtenha sua chave de API em Configurações → Chaves de API no painel (hospedado ou auto-hospedado).

Claude Desktop

Adicione ao seu 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-Hospedado

Para auto-hospedado, substitua https://epitome.fyi por http://localhost:3000.

Epitome expõe 3 ferramentas MCP — recall, memorize e review. Veja a referência completa de ferramentas.

Para Quem É Isso

Desenvolvedores de IA construindo agentes que precisam de memória persistente do usuário
Usuários avançados que querem que toda IA se lembre deles em todas as plataformas
Auto-hospedadores que desejam propriedade total dos dados — sem necessidade de nuvem

Casos de Uso

Seu agente de rastreamento de refeições lembra suas alergias
Seu assistente de codificação conhece sua stack, seus padrões, sua equipe
Seu agente de calendário conhece sua família, suas prioridades, suas rotinas
Cada nova ferramenta de IA que você experimenta já te conhece no primeiro dia

Por que Epitome?

	Banco de Dados Vetorial	Epitome
Identidade portátil		✓
Memória compartilhada multiagente		✓
Grafo de conhecimento		✓
Consentimento e auditoria por agente		✓
Isolamento de esquema por usuário		✓
Dados estruturados + semânticos	parcial	✓
Auto-hospedável	✓	✓

As Cinco Camadas

#	Camada	Descrição
01	Banco de Dados Pessoal	Tabelas estruturadas, memória semântica vetorial e armazenamento chave-valor. Seus dados residem no PostgreSQL — consultáveis, exportáveis, seus.
02	Identidade Portátil	Um perfil estruturado que qualquer agente de IA lê instantaneamente. Nome, preferências, relacionamentos — zero partida a frio, toda conversa.
03	Qualidade da Memória	Pontuação de confiança, atribuição de fonte e gerenciamento de ciclo de vida. Memórias ganham confiança por reforço, não por fé cega.
04	Grafo de Conhecimento	Entidades com arestas tipadas e ponderadas. Pessoas, lugares, conceitos — conectados em um grafo que cresce a cada interação.
05	Consentimento e Auditoria	Permissões por tabela e um registro de atividades somente de acréscimo. Você controla exatamente o que cada agente pode ver e fazer.

Arquitetura

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

Cada usuário recebe seu próprio esquema PostgreSQL (user_{id}) — não segurança em nível de linha, isolamento completo em nível de esquema. O acesso entre esquemas é impossível no nível SQL.

Veja EPITOME_TECH_SPEC.md para a arquitetura completa.

Segurança e Privacidade

Você é dono dos seus dados — auto-hospede ou use o serviço hospedado
Isolamento de esquema PostgreSQL por usuário — não segurança em nível de linha, separação completa de esquema
Regras de consentimento por agente — você controla o que cada agente pode ler e escrever
Registro de auditoria somente de acréscimo — todo acesso é registrado
Pronto para GDPR — exporte ou exclua todos os seus dados a qualquer momento

Stack de Tecnologia

Componente	Tecnologia
Runtime	Node.js 22 LTS
API	Hono
Banco de Dados	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
Frontend	React 19 + Tailwind CSS 4 + shadcn/ui
Validação	Zod
Testes	Vitest

Documentação

Início Rápido — Funcionando em minutos
SDK JavaScript — Construa com @epitomefyi/sdk
Pacote npm — Instalação e histórico de versões
Ferramentas SDK de IA — searchMemory, saveMemory, getUserContext para chamada de ferramentas
Referência da API — Documentação dos endpoints REST
Ferramentas MCP — Todas as 3 ferramentas MCP explicadas
Arquitetura — Especificação técnica completa
Modelo de Dados — Cada tabela, coluna e restrição
Guia de Auto-Hospedagem — Implantação com Docker Compose
Segurança — Isolamento, consentimento e auditoria

Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md para diretrizes.

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

Então abra um PR — ficaremos felizes em ajudar com sua primeira contribuição.

Licença

MIT