Epitome

resmi

Kişisel AI belleği — her AI ajanına sizinle ilgili paylaşılan, kalıcı bir bellek sağlar

GitHub

Epitome MCP ile neler yapabilirsiniz?

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.

Dokümantasyon

Epitome

Tek bellek katmanı, her yapay zeka ajanı.

Her yapay zeka ajanına sizinle ilgili paylaşılan, kalıcı bir bellek veren taşınabilir kimlik katmanı.
Açık kaynak. Kendi sunucunuzda barındırılabilir. Size ait.

Web Sitesi · Hızlı Başlangıç · Bir Ajan Bağlayın · Dokümanlar · Katkıda Bulunma

Sorun

Her yapay zeka sohbeti sıfırdan başlar. Kendinizi her ajana tekrar tekrar anlatırsınız — adınız, tercihleriniz, alerjileriniz, teknoloji yığınınız. Sohbet geçmişi uygulama başına yalıtılmıştır. Taşınabilir bir bellek katmanı yoktur.

Epitome bunu düzeltir. Her yapay zeka ajanının paylaştığı tek bir veritabanı, böylece hepsi sizi hatırlar.

Hızlı Başlangıç

Barındırılan (en hızlı)

epitome.fyi adresinden kaydolun
Ayarlar → API Anahtarları'na gidin ve MCP URL'nizi kopyalayın
Bir yapay zeka ajanı bağlayın — tamamlandı

Kendi Sunucunuzda

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

localhost:5173 adresini açın ve Google veya GitHub OAuth ile giriş yapın.

Bir Yapay Zeka Ajanı Bağlayın

Kontrol panelinden (barındırılan veya kendi sunucunuzda) Ayarlar → API Anahtarları'ndan API anahtarınızı alın.

Claude Desktop

claude_desktop_config.json dosyanıza ekleyin:

{
  "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

Kendi Sunucunuzda

Kendi sunucunuzda barındırma için https://epitome.fyi yerine http://localhost:3000 kullanın.

Epitome 3 MCP aracı sunar — recall, memorize ve review. Tam araç referansına bakın.

Kimler İçin

Kalıcı kullanıcı belleğine ihtiyaç duyan ajanlar geliştiren yapay zeka geliştiricileri
Her yapay zekanın kendilerini platformlar arası hatırlamasını isteyen ileri düzey kullanıcılar
Tam veri sahipliği isteyen — bulut gerektirmeyen kendi sunucusunda barındıranlar

Kullanım Örnekleri

Yemek takip ajanınız alerjilerinizi hatırlar
Kodlama asistanınız yığınınızı, desenlerinizi, ekibinizi bilir
Takvim ajanınız ailenizi, önceliklerinizi, rutinlerinizi bilir
Denediğiniz her yeni yapay zeka aracı sizi birinci günden tanır

Neden Epitome?

	Vektör VT	Epitome
Taşınabilir kimlik		✓
Çok ajanlı paylaşılan bellek		✓
Bilgi grafiği		✓
Ajan başına onay ve denetim		✓
Kullanıcı başına şema izolasyonu		✓
Yapılandırılmış + anlamsal veri	kısmi	✓
Kendi sunucusunda barındırılabilir	✓	✓

Beş Katman

#	Katman	Açıklama
01	Kişisel Veritabanı	Yapılandırılmış tablolar, vektör anlamsal bellek ve anahtar-değer depolama. Verileriniz PostgreSQL'de yaşar — sorgulanabilir, dışa aktarılabilir, size ait.
02	Taşınabilir Kimlik	Her yapay zeka ajanının anında okuyabileceği yapılandırılmış bir profil. İsim, tercihler, ilişkiler — sıfır soğuk başlangıç, her sohbet.
03	Bellek Kalitesi	Güven puanlaması, kaynak atfı ve yaşam döngüsü yönetimi. Anılar kör inançla değil, pekiştirme yoluyla güven kazanır.
04	Bilgi Grafiği	Tiplendirilmiş, ağırlıklı kenarlara sahip varlıklar. İnsanlar, yerler, kavramlar — her etkileşimle büyüyen bir grafikte bağlanır.
05	Onay ve Denetim	Tablo başına izinler ve yalnızca eklenebilir etkinlik günlüğü. Her ajanın neyi görüp yapabileceğini tam olarak siz kontrol edersiniz.

Mimari

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

Her kullanıcı kendi PostgreSQL şemasını alır (user_{id}) — satır düzeyinde güvenlik değil, tam şema düzeyinde izolasyon. SQL düzeyinde şemalar arası erişim imkansızdır.

Tam mimari için EPITOME_TECH_SPEC.md dosyasına bakın.

Güvenlik ve Gizlilik

Verileriniz size aittir — kendi sunucunuzda barındırın veya barındırılan hizmeti kullanın
Kullanıcı başına PostgreSQL şema izolasyonu — satır düzeyinde güvenlik değil, tam şema ayrımı
Ajan başına onay kuralları — her ajanın ne okuyup yazabileceğini siz kontrol edersiniz
Yalnızca eklenebilir denetim günlüğü — her erişim kaydedilir
GDPR uyumlu — tüm verilerinizi istediğiniz zaman dışa aktarın veya silin

Teknoloji Yığını

Bileşen	Teknoloji
Çalışma Zamanı	Node.js 22 LTS
API	Hono
Veritabanı	PostgreSQL 17 + pgvector
MCP	@modelcontextprotocol/sdk
Ön Yüz	React 19 + Tailwind CSS 4 + shadcn/ui
Doğrulama	Zod
Test	Vitest

Dokümantasyon

Hızlı Başlangıç — Dakikalar içinde çalışmaya başlayın
JavaScript SDK — @epitomefyi/sdk ile geliştirin
npm Paketi — Kurulum ve sürüm geçmişi
AI SDK Araçları — Araç çağırma için searchMemory, saveMemory, getUserContext
API Referansı — REST uç noktası dokümantasyonu
MCP Araçları — 3 MCP aracının tümü açıklandı
Mimari — Tam teknik şartname
Veri Modeli — Her tablo, sütun ve kısıtlama
Kendi Sunucusunda Barındırma Kılavuzu — Docker Compose dağıtımı
Güvenlik — İzolasyon, onay ve denetim

Katkıda Bulunma

Katkılar memnuniyetle karşılanır! Yönergeler için CONTRIBUTING.md dosyasına bakın.

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

Ardından bir PR açın — ilk katkınızda size yardımcı olmaktan mutluluk duyarız.

Lisans

MIT