🧠 avenoxbeyin V3

Claude Code, Codex veya Google Antigravity ile kullanabileceğin yerel ikinci beyin. Notların Markdown dosyalarında kalır; bir istemcide kaydettiğin kaynak ve iş sonucu diğerinde de bulunabilir. Obsidian ile açabilir, normal bir metin editörüyle düzenleyebilirsin.

Python 3.11 veya üzeri yeterli. Git, pip, Mem0 hesabı, API anahtarı veya sürekli açık sunucu gerekmez. Kullandığın AI istemcisinin kendi kurulumu ve hesabı ayrı olarak gerekir.

V3.0.2: Windows güncelleme kilitleri ve Unicode/Git Bash hook yolları düzeltildi; harici skill symlink'leri korunuyor ve yeni oturumda süreklilik dosyaları öncelikli yükleniyor. Yerel paket kapısında 139 test ve 10/10 + 6/6 semantik senaryo geçti; native Windows işleri de yeşil. Platform doğrulaması · Gerçek istemci ve Desktop kapsamı.

En kolay kurulum: bir klasör, bir mesaj

1. Obsidian'da yeni bir vault oluştur veya mevcut vault klasörünü seç.
2. Bu klasörü Codex, Claude Code veya Antigravity ile aç.
3. Aşağıdaki mesajı yapıştır:

https://avenox.lol/beyin.md adresini oku. Bu klasöre ikinci beynimi kur. Mevcut kurulum varsa notlarımı koruyarak güncelle. Gerekli indirme ve kurulum adımlarını sen yap. Sonunda örnek bir bilgiyi kaydedip yeni oturumda geri okuyarak birlikte doğrulayalım.

Ajan resmi kararlı paketi bulur, checksum ile doğrular, geçici alanda açar, kurulumu yapar ve sağlık kontrolünü çalıştırır. Kullanıcı yalnızca istemcinin gösterdiği normal klasör, workspace veya hook güven incelemesini tamamlar.

Görsel anlatım, kopyalanabilir mesaj ve manuel indirme: avenox.lol/ikincibeyin.

Manuel kurulum

1. V3.0.2 sürüm sayfasını aç. beyin-v3-3.0.2.zip dosyasını ve yanındaki SHA-256 dosyasını indir. GitHub'ın otomatik “Source code” arşivi yerine bu paketi seç.
2. Obsidian'da bir vault oluştur veya mevcut vault klasörünü seç. Notlarını başka yere taşıman gerekmez.
3. Açtığın paket klasöründe terminal aç ve vault yolunu kendi klasörünle değiştir:

macOS / Linux:

python3 scripts/install_v3.py --vault "/tam/yol/Beynim"

Windows:

py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim"

Kurulum üç istemci için proje bağlantılarını, ortak motoru, üç başlangıç skill'ini ve güncelleme kısayolunu kurar. Bundan sonra paket klasörünü açık tutman gerekmez.

Hermes Agent kullanıyorsan aynı motor bir Hermes eklentisi üzerinden bağlanır; installer eklenti dosyalarını vault içine yazar, ama profil bazlı bağlantı ve hermes plugins enable beyin-v3 adımını sen yaparsın. Adımlar: docs/v3/HERMES.md. Bu destek kaynak checkout'undadır; yukarıda bağlantısı verilen V3.0.2 release ZIP'inde henüz yoktur.

Vault klasörünü kullandığın AI istemcisinde açıp yeni bir oturum başlat. Codex'te /hooks ekranında yeni hook tanımlarını inceleyip güven; diğer istemcilerde workspace güvenini tamamla. İstemci güvenini kurucu senin adına uydurmaz. Agent ile kurulum yapmak istersen SETUP-V3.md rehberini takip etmesini iste.

OpenCode için ek adım yok: installer vault içine eklentisini yazar, OpenCode vault klasöründe açılınca aynı motora bağlanır. Adımlar: docs/v3/OPENCODE.md.

İlk konuşma

main dalındaki kişilik/süreklilik düzeltmesi: yeni kurulum düşünme ortağı kimliğini ve başlangıç notlarını oluşturur; mevcut Core/Soul, kullanıcı düzeltmeleri, aktif konular ve son oturum kaynakları açılışta önceliklidir. Kalıcı öğrenimler aktif ajan tarafından kavram ve bağlantı notlarına işlenir. V2/V3 karşılaştırması ve doğrulama. Bu değişiklik henüz yukarıdaki V3.0.2 release ZIP'inde değildir.

Ajanına şunu söyle:

Beyin skill'ini kullan. Beni tanımak için kısa sorular sor; cevapları kaynak notlara kaydet. Sonra birlikte bir görev oluşturup tekrar okuyalım.

Kurulu üç skill:

Bunlar .agents/skills altında bulunur; istemciler aynı kaynakları kullanır. Eklemek istediğin kişisel skill'leri ayrıca içe alabilirsin. Aynı adlı farklı içerik sessizce ezilmez.

Günlük kullanım

Notu yaz, ajana ne istediğini söyle. Kaynaklar oturum açılışı ve konuşmanın uygun noktalarında yeniden indekslenir. İstemciler kapalıyken sürekli tarayan bir servis yoktur. Önemli iş sonuçları kısa, kaynak bağlantılı kayıtlarla tutulur; tüm sohbetin kendiliğinden doğru bilgiye dönüştüğü iddia edilmez.

Bir şey ters giderse ajana “beyin-doktor ile kontrol et” de. Terminalden, vault klasöründe:

python3 beyin.py doctor

Windows'ta aynı komutun başında py -3 kullan. Kurulumda özel runtime yolu seçtiysen kurulu beyin.py bunu zaten bilir.

Tüketim ve kontrol sıklığı

Ajanına “ekonomik moda geç”, “otomatik kontrolleri kapat” veya “kontrol aralığını 30 dakika yap” diyebilirsin. Üç istemci aynı vault tercihini kullanır; güncellemeler tercihini korur.

Süre dolunca kendi başına çalışan bir zamanlayıcı kurulmaz; bir sonraki istemci olayı kontrolü başlatır. İstemciler kapalıyken işlem yapılmaz. Yerel Python kontrolleri model çağırmaz; otomatik Luna/Sonnet maliyeti yoktur. Ajana yaptırdığın işler ve eklenen bağlam normal istemci tüketimine girer. Ekonomik veya manuel modda gerektiğinde kaynaklar açık context/sync komutuyla tazelenir.

Tercihler: python3 beyin.py preferences. Ekonomik: preferences --profile economical. Manuel: preferences --profile manual. Aralık: preferences --interval-minutes 30. Opt-in sır süzgeci: preferences --secret-filter on. Windows'ta py -3 kullan. Ayrıntılar.

Güncelleme

Ajanına “beynimi güncelle” diyebilir veya vault içindeki kısayolu açabilirsin:

• macOS: Beyni Güncelle.command
• Windows: Beyni Guncelle.cmd
• Linux: Beyni Güncelle.desktop veya Beyni Güncelle.sh

Kısayol aynı updater'ı çalıştırır. Terminalde önce kontrol etmek istersen:

python3 beyin.py update --check
python3 beyin.py update

Varsayılan kaynak yalnız resmi GitHub stable release paketidir; geliştirme dalından kendiliğinden kod çekmez. Paket yayınlanmamışsa veya erişilemiyorsa hata bildirir, güncellenmiş gibi davranmaz. İndirilmiş ZIP ile çevrimdışı güncelleme ve geri alma için güncelleme rehberi.

V2'den geliyorsan

Aynı kurucuyu mevcut vault üzerinde çalıştır. Notlar, Companion dosyaları, eski daily/ ve knowledge/ içerikleri korunur. Tanınan eski writer'lar geri alınabilir biçimde devreden çıkarılır; özelleştirilmiş sistem dosyası veya çalışan eski worker varsa işlem durur ve açıklama verir.

V2'nin arka planda model çağıran günlük özetleyici/derleyici akışı V3'te çalışmaz. Bunun yerine aktif ajan bilinçli olarak iş sonucu ve bilgi notu yazar. Yeni sonuç bağlantıları daily/v3/ ve knowledge/v3/outcomes.md altında oluşturulur. Eski günlükler yeniden özetlenmez. Geçiş ve sınırları · Tarihsel V2 rehberi.

Ne korunur, ne ölçülür?

Kullanıcı notları updater'ın değiştireceği sistem dosyaları değildir. Yönetilen dosyada farklı bir değişiklik görülürse conflict bildirilir; ilgisiz desteklenen ayar değişiklikleri birleştirilir. Yedek ve journal vault dışında yereldir. Bir kesinti sonrası recover veya rollback kullanılabilir.

Arama yerel kelime eşleştirmesi kullanır; genel doğal dil anlama veya her soruda doğru hatırlama sözü vermez. Motor kendisi model çağırmaz; ajana yaptırdığın işler istemcinin normal kullanımına girer. Otomatik doğrulamalar ve gerçek istemci kontrolleri ayrı raporlanır.

Geliştiriciler

Kaynak formatı · Runtime · Semantik test sözleşmesi · Sürüm paketi ve updater.

Açık kaynak, MIT lisansı. Avenox tarafından günlük ikinci beyin iş akışlarından geliştirildi. V2 bilgi derleme fikri için Karpathy'nin bilgi tabanı desenine teşekkürler.