Localmind — Yerel AI Hafıza Sistemi
Localmind, düz not tutmanın ötesine geçen bir hafıza sistemidir. Bilgiler vektör temsilleri (embeddings) olarak saklanır; arama yaparken kelime eşleşmesi değil, anlam benzerliği kullanılır.
NixOS Yapılandırma Sistemi ile tam entegre çalışır. Komutları otomatize etmek isterseniz LocalGhost projesine de göz atabilirsiniz.
Nasıl Çalışıyor?
Çift Katmanlı Arama Motoru: Sistem sadece semantik değil, hibrid bir arama kullanıyor:
- ChromaDB: Ollama üzerinden vektörleştirilen veriler ChromaDB’ye yazılır. Semantik yakınlık ile “GPU sorunları” ve “ekran kartı problemleri” eşleşir.
- SQLite + FTS5 (Full-Text Search): ChromaDB ile paralel çalışan bu katman, kesin kelime eşleşmeleri ve BM25 algoritması ile skorlama yapar.
Akıllı Upsert: Yeni bilgi eklenirken LLM (Qwen 2.5 veya Gemma) mevcut hafızalarla karşılaştırıp üç işlemden birini seçer:
create— Bilgi tamamen yeni, ChromaDB’ye insert et.update— Mevcut bir hafızanın güncellemesi, var olan vektörü değiştir.skip— Sistem bunu zaten biliyor, işlem yapma.
FastMCP Entegrasyonu: Model Context Protocol bridge (FastMCP) üzerinden Claude Code ve diğer AI asistanları Localmind’a bağlanabilir. Stateless mimari sayesinde her araç çağrısı bağımsız çalışır ve sistem memory leak’lere karşı korumalıdır.
Stack ve Altyapı
- FastMCP: 10 farklı MCP aracını (hafızaya yaz, arama yap, oda listele vb.) barındıran protokol katmanı.
- ChromaDB: Yüksek performanslı yerel vektör veritabanı.
- SQLite + FTS5: BM25 keyword indeksi ve entity-relation grafiği (Nodes & Edges).
- Ollama: Embedding üretimi (Gemma3 vb.) ve konuşma özetleme inference motoru.
- D3.js Dashboard: Zihin sarayını görselleştiren, ilişki grafiği çizen WebUI.
NixOS Dağıtım Mimarisi
Sistem bir systemd user servisi olarak arka planda uyur. Gerektiğinde ai-start komutuyla Ollama ve ChromaDB servisleri ayağa kalkar, ai-stop ile kaynaklar tamamen boşaltılır (Zero-Idle footprint).