OMEGA

AI ajanları için çapraz model hafızası. Yerel-öncelikli. Claude, GPT, Gemini, Cursor, Claw Code ve herhangi bir MCP istemcisiyle çalışır. Ajanınızın beyni başkasının sunucusunda yaşamamalı veya tek bir sağlayıcıya kilitlenmemelidir.

Sorun

AI kodlama ajanları durumsuz (stateless) çalışır. Her yeni oturum sıfırdan başlar. "Çözümler" ya sizi tek bir model sağlayıcısına kilitler ya da kod tabanı bağlamını bulutlarına gönderir.

• Bağlam kaybı. Ajanlar oturumlar arasında her kararı, tercihi ve mimari seçimi unutur. Geliştiriciler oturum başına 10-30 dakika zaten kurulmuş olan bağlamı yeniden açıklamakla geçirir.
• Tekrarlanan hatalar. Geçmiş oturumlardan öğrenmeden, ajanlar aynı hataları tekrar tekrar yaparlar. Ne işe yaradığını, ne başarısız olduğunu veya neden belirli bir yaklaşımın seçildiğini hatırlamazlar.
• Bulut hafızası = başkasının veritabanı. Mem0 gibi hizmetler API anahtarları gerektirir ve verilerinizi sunucularına gönderir. Fiyatlandırmalarını değiştirdiğinde, satın alındığında veya çöktüğünde, ajanınızın birikmiş zekası kaybolur.
• Satıcı bağlantısı (vendor lock-in). Anthropic'in Memory Tool sadece Claude ile çalışır. OpenAI'nin memory sadece GPT ile çalışır. Model değiştirin, hafızanızı kaybedin.

OMEGA bunu çözer. Tamamen makinenizde çalışan hafıza, koordinasyon ve öğrenme. Her büyük LLM ve kodlama ajanıyla çalışır. Bulut yok. API anahtarı yok. Satıcı bağlantısı yok.

Hızlı Kurulum

pip install omega-memory[server]    # Tam kurulum (hafıza + MCP sunucusu)
omega setup                         # Modeli indirir, MCP'yi kaydeder, hook'ları yükler
omega doctor                        # Her şeyin çalıştığını doğrula

Claude Desktop

pip install omega-memory[server]
omega setup --client claude-desktop

Bu, OMEGA'yı Claude Desktop'ın yapılandırmasında MCP sunucusu olarak kaydeder. Etkinleştirmek için Claude Desktop'ı yeniden başlatın.

Cursor, Claw Code, Windsurf, Cline, Codex

pip install omega-memory[server]
omega setup --client cursor      # veya: claw-code, windsurf, cline, codex

pip install omega-memory    # Çekirdek yalnız, MCP sunucusu işlemi yok

from omega import store, query, remember

store("Always use TypeScript strict mode", "user_preference")
results = query("TypeScript preferences")

omega setup --hooks-only    # Oto-yakalama + hafıza yüzeyleme, MCP sunucusu yok (~600MB RAM tasarrufu)

Kaynaktan

git clone https://github.com/omega-memory/omega.git
cd omega
pip install -e ".[server,dev]"
omega setup

omega setup şu işlemleri yapacak:

1. ~/.omega/ dizinini oluşturur
2. ONNX embedding modelini (~90 MB) ~/.cache/omega/models/ konumuna indirir
3. omega-memory'yi MCP sunucusu olarak kaydeder (Claude Code otomatik algılanır veya --client belirtin)
4. Oturum hook'larını ~/.claude/settings.json konumuna yükler
5. ~/.claude/CLAUDE.md dosyasına OMEGA bloğu ekler

60 Saniyede Başlangıç

OMEGA doğal dil aracılığıyla çalışır — API çağrısı yok, yapılandırma yok. Sadece Claude ile konuşun.

1. Claude'a bir şeyi hatırlamasını söyleyin:

"Remember that the auth system uses JWT tokens, not session cookies"

Claude bunu semantik gömülümleri ile kalıcı bir hafıza olarak depolar.

2. Oturumu kapatın. Yeni bir tane açın.

3. Sorguyla ilgili sorun:

"What did I decide about authentication?"

OMEGA ilgili hafızayı otomatik olarak yüzeye çıkarır:

Found 1 relevant memory:
  [decision] "The auth system uses JWT tokens, not session cookies"
  Stored 2 days ago | accessed 3 times

Hepsi bu. Hafızalar oturumlar arasında kalıcı olur, zaman içinde birikir ve açık sorulmasa bile ilgili olduğunda otomatik olarak yüzeye çıkarılır.

Temel Özellikler

• Hafıza & Öğrenme — Kararları, dersleri, hata düzenlerini ve tercihleri semantik aramalarla depolar. Claude, her şeyi yeniden açıklamanıza gerek kalmadan önemli olanı geri çağırır. Sıkıştırma, konsolidasyon, zaman çizelgesi, grafik geçişi ve bağlam sanallaştırması (kontrol noktası/devam) dahil 25 hafıza aracı.

• Çoklu Ajan Koordinasyonu (omega-pro) — Dosya ve dal kilitlemesi, oturum yönetimi, bağımlılıkları olan görev kuyrukları, niyet yayını ve ajan-ajan mesajlaşması. Ajanların birbirlerinin çalışmalarını üzerine yazmasını önleyen 29 koordinasyon aracı.

• Akıllı LLM Yönlendirmesi (omega-pro) — Görevleri sınıflandırır ve en uygun modele yönlendirir. Kodlama → Claude Sonnet. Hızlı düzenleme → Llama 8b (1/60 maliyetle). 1M token bağlamı → Gemini Flash. 5 sağlayıcı, 4 öncelik modu, 2ms'den az niyet sınıflandırması.

• Bilgi Tabanı (omega-pro) — PDF, markdown, web sayfaları ve metin dosyalarını semantik böme ile aranabilir bir bilgi tabanına işle.

• Varlık Kaydı (omega-pro) — İlişkiler, hiyerarşiler ve varlık kapsamlı hafızalar/profiller/belgeler ile çoklu varlık kurumsal hafızası.

• Güvenli Profil (omega-pro) — macOS Keychain entegrasyonu ile AES-256 şifrelenmiş kişisel veri depolama.

OMEGA Nasıl Karşılaştırılır

Anthropic'in Memory Tool, verileri istemci tarafında depolama yapar ancak tüm hafıza işlemleri için Claude API çağrıları gerektirir. OMEGA tamamen cihazda çalışır; gömülümler (ONNX) dahil.

Anthropic Memory, Anthropic için. OMEGA herkes için.

Mimari

     Claude Code  ·  Cursor  ·  Claw Code  ·  Herhangi bir MCP İstemcisi
               │         │         │              │
               └─────────┴─────┬───┴──────────────┘
                               │ stdio/MCP
               ┌───────────────▼─────────────┐
               │   OMEGA MCP Sunucusu │
               │   25 çekirdek aracı   │
               └──┬──────────────────┘
                  │
         ┌────────▼──────────────┐
         │ Çekirdek Hafıza Motoru│
         │ (semantik arama,     │
         │  gömülümler, grafikler) │
         └─────┬─────────────────┘
               │
               ▼
         ┌──────────────────────────────────────┐
         │         omega.db (SQLite)             │
         │  memories | edges | embeddings        │
         └──────────────────────────────────────┘

Tek veritabanı, modüler işleyiciler. İsteğe bağlı modüller (koordinasyon, yönlendirici, varlık, bilgi, profil) omega-pro aracılığıyla kullanılabilir ve aynı sunucu işlemine kaydedilir. Ayrı daemon yok, mikro hizmet yok.

MCP Araçları Referansı

OMEGA, Claude Code içinde MCP sunucusu olarak çalışır. Çekirdek paket 25 hafıza aracı sağlar. omega-pro koordinasyon, yönlendirme, varlık, bilgi ve profil araçları ekler.

Hafıza (25 aracı)

omega-pro ile ek araçlar

CLI

Sorun Giderme

omega doctor içe aktarmada FAIL gösterir:

• Depo kökünden pip install -e ".[server]" sürümünü sağla
• python3 -c "import omega" işleminin çalışıp çalışmadığını kontrol et

MCP sunucusu başlayamıyor:

• pip install omega-memory[server] çalıştır (the [server] ek dosyası MCP paketini içerir)

MCP sunucusu kayıtlı değil:

claude mcp add omega-memory -- python3 -m omega.server.mcp_server

Hook'lar ateşlemiyor:

• ~/.claude/settings.json öğesinin OMEGA hook girişleri içerip içermediğini kontrol et
• ~/.omega/hooks.log hatalar için kontrol et

Geliştirme

pip install -e ".[server,dev]"
pytest tests/                # 2198+ test
ruff check src/              # Lint

Kaldır

claude mcp remove omega-memory
rm -rf ~/.omega ~/.cache/omega
pip uninstall omega-memory

OMEGA girişlerini ~/.claude/settings.json dosyasından ve <!-- OMEGA:BEGIN --> bloğunu ~/.claude/CLAUDE.md dosyasından el ile kaldırın.

Katkıda Bulunma

• Katkıda Bulunma Kılavuzu
• Güvenlik Politikası
• Değişim Günlüğü
• Hata Bildir

Lisans

Apache-2.0. LICENSE dosyasına bakın.