Yapay zeka ajanlarının uzun vadeli hafızalarını oluşturmasına yardımcı olan yeni bir wiki sistemi, geliştiriciler tarafından açık kaynak olarak sunuldu. WUPHF adı verilen bu araç, Markdown dosyaları ve Git deposu kullanarak bilgiyi kalıcı ve taşınabilir bir şekilde saklıyor.
Basitlikten Güç Doğuran Bir Tasarım
WUPHF, Stanford araştırmacısı Andrej Karpathy’nin yakın zamanda vurguladığı "LLM-native knowledge substrate" fikrinden esinleniyor. Bu kavram, yapay zeka ajanlarının bilgiyi birbirleriyle paylaşmasını ve sürekli olarak zenginleştirmesini sağlayan bir veri katmanını tanımlıyor. Geleneksel sistemler genellikle PostgreSQL, vektör veritabanları ya da Neo4j gibi karmaşık altyapılar üzerine inşa edilirken, WUPHF bu ihtiyacı en temel araçlarla karşılıyor: sıradan metin dosyaları ve Git deposu.
Projeyi geliştiren ekip, ağır sistemler eklemeden önce ilk olarak Markdown ve Git’in ne kadar uzağa gidebileceğini test etmeyi tercih etmiş. Sonuçta ortaya çıkan sistem, herhangi bir bulut bağımlılığı olmadan yerel olarak çalışıyor ve kullanıcıların verilerini ~/.wuphf/wiki/ dizinine kaydediyor. Bu sayede, bilgiler doğrudan Git ile dışa aktarılabiliyor ve başka bir sisteme taşınabiliyor.
Ajanların Kendi Not Defterlerinden Ortak Bilgi Tabanına
WUPHF’in en dikkat çekici özelliklerinden biri, ajanlara özel not defterleri ve takım için ortak bir wiki sunması. Her ajan için agents/{slug}/notebook.md adlı özel bir dosya oluşturulurken, takımın tamamı team/ dizinindeki ortak bir wiki’ye erişebiliyor.
Sistem, taslaktan wiki’ye geçiş akışını otomatik olarak yönetiyor:
- Ajanlar ya da kullanıcılar tarafından oluşturulan not defteri girişleri, önce inceleniyor.
- Onaylanan içerikler, referans bağlantılarıyla birlikte resmi wiki’ye aktarılıyor.
- Bir basit durum makinesi, hem girişlerin süresini takip ediyor hem de arşivlenmesi gereken içerikleri otomatik olarak işaretliyor.
Bu akış, ajanların her oturumda aynı bilgileri yeniden girmek zorunda kalmadan, zaman içinde biriken bilgiyi kullanmasına olanak tanıyor.
Verinin Yapısal Tutulması: Faktların ve Varlıkların İzlenmesi
WUPHF, yalnızca metin depolamakla kalmıyor, aynı zamanda verilerin yapısal olarak izlenmesini de sağlıyor. Her varlık için (team/entities/{kind}-{slug}.facts.jsonl), yalnızca ekleme yapılan bir JSON satır dosyası oluşturuluyor. Bir sentezleme işçisi, belirli aralıklarla bu verileri birleştirerek anahtar bilgi özetlerini yeniden inşa ediyor.
Tüm değişiklikler, "Pam the Archivist" adlı özel bir Git kullanıcısı tarafından kaydediliyor. Bu sayede, verilerin kökeni ve geçmişi Git geçmişinde şeffaf bir şekilde görülebiliyor.
Ayrıca sistem, çapraz referans bağlantıları (wikilinks) desteği sunuyor. Bağlantıların kırık olup olmadığı otomatik olarak tespit ediliyor ve kırık bağlantılar kırmızı olarak işaretleniyor. Günlük bir denetim cron görevi de çelişkili girişleri, eski kalıntıları ve kırık bağlantılar bulmaya yardımcı oluyor.
Gerçek Zamanlı Arama ve Sorgulama Desteği
WUPHF, ajanların ve kullanıcıların bilgiye hızlı bir şekilde ulaşmasını sağlamak için gelişmiş bir arama mekanizması sunuyor:
- /lookup komutu aracılığıyla yapılan sorgular, verilerin hızlı bir şekilde bulunmasını sağlıyor.
- MCP aracı, kaynaklarla desteklenen cevaplar üretmek için kullanılabiliyor.
- Kısa sorgular için BM25 indeksi, daha karmaşık anlatısal sorgular için ise alıntılı cevap döngüleri kullanılıyor.
Performans ve Gelecek Planları
Sistem, halihazırda 500 belge ve 50 sorgu üzerinde test edilmiş durumda. Bu testlerde, yalnızca BM25 indeksi kullanılarak %85 geri getirme oranı elde edilmiş. Bu metrik, sistemin iç kullanım için yeterli kabul ediliyor. Geliştiriciler, gerektiğinde sqlite-vec vektör arama motorunu devreye almayı planlıyor.
WUPHF’in en önemli özelliklerinden biri de kanonik tanımlayıcılar kullanması. Her olgu için atanan tanımlayıcılar, cümle konumunu da içeriyor ve böylece verilerin benzersizliği garanti altına alınıyor. Ayrıca, varlıkların adları hiç değiştirilmeden, yalnızca yönlendirme yer imleriyle birleştiriliyor.
Sınırlamalar ve Gelecek Geliştirmeler
Mevcut sistemin bazı sınırlamaları bulunuyyor:
- Geri getirme doğruluğunun iyileştirilmesi devam ediyor. %85’lik başarı oranı, tüm senaryolarda garanti altına alınmış değil.
- Sentez kalitesi, ajanların gözlem kalitesine bağlı olarak değişiyor. Yanlış ya da eksik verilerden oluşan özetler, sistemin performansını doğrudan etkiliyor.
Geliştiriciler, sistemin tek ofis ortamına odaklandığını ve gelecekte çoğul ortamlar arası senkronizasyon desteği eklenmesini planlıyor. Ayrıca, kullanıcıların Obsidian vault’larına plugin ekleyerek benzer bir sistemi kurup kuramayacakları da merak konusu.
Kimler İçin Uygun?
WUPHF, Claude Code, Codex, OpenClaw gibi popüler yapay zeka ajanlarıyla çalışan ekipler için ideal. Açık kaynaklı ve MIT lisansı altında yayınlanan sistem, kendi anahtarlarınızı kullanarak yerel olarak çalıştırılabiliyor. Tam bir ofis aracı olmamasına rağmen, wiki katmanı bağımsız olarak da kullanılabiliyor.
Kurulum oldukça basit:
npx wuphf@latestSistem, ajanlarınızın mevcut ayarlarına entegre edilebiliyor. Böylece, kullanıcılar ek bir altyapı karmaşasına girmeden bilgilerini merkezi ve güvenilir bir şekilde yönetebiliyorlar.
Sonuç: Basitlikten Doğan Güç
WUPHF, yapay zeka ajanlarının bilgiyi yönetme şeklini yeniden tanımlıyor. Karmaşık veritabanları ya da bulut hizmetlerine gerek kalmadan, yalnızca Markdown ve Git kullanarak uzun vadeli, güvenilir ve taşınabilir bir bilgi tabanı oluşturuyor. Geliştiriciler, sistemin gelecekteki versiyonlarında vektör arama ve çoklu ortam senkronizasyonu gibi özellikleri eklemeyi planlıyor.
Bu yaklaşım, yapay zeka çağında bilgiyi saklamanın ve paylaşmanın en basit ama en etkili yollarından biri olarak öne çıkıyor.
Yapay zeka özeti
Yapay zeka ajanlarının bilgiyi sürekli güncelleyebileceği bir wiki sistemi olan WUPHF’i keşfedin. Markdown ve Git ile çalışan bu açık kaynaklı araç hakkında detaylar burada.


