avenoxbeyin README

项目的 README,来自 github.com/avenoxai/avenoxbeyin。合并为一个 markdown 文件:README.md。

İkinci Beyin

İkinci Beyin: farklı ajanlar aynı Markdown notlarına bağlanır.

AI istemcin değişse de notların, kararların ve görevlerin aynı yerde kalsın.

AvenoxBeyin, AI ajanlarınla kullanabileceğin yerel bir hafıza sistemi. Önemli bilgiyi Markdown dosyalarına kaydettirir, sonraki oturumda kaynağıyla bulursun. Klasörünü Obsidian'da veya istediğin metin editöründe açabilirsin.

Kuruluma geç · Son sürümü indir · Görsel kurulum rehberi · Belgeler

macOS · Windows · Linux   |   Python 3.11+   |   MIT lisansı

Ne işe yarar?

İstediğin Beyin ile yapabileceğin
Yeni oturumda kaldığın yerden devam etmek Son işin sonucunu, açık konuları ve sonraki adımı kaynak notlara kaydetmek
Daha önce verdiğin kararı bulmak Notlarda aramak, kararın geçtiği dosyayı açmak
Bir kaynağı kaybetmemek Video, makale veya dosyayı Yakala ile gelen kutuna almak
Claude'dan Codex'e geçmek Aynı klasördeki not ve görevleri başka bir desteklenen istemciyle kullanmak

Kasanın ayrı bir kopyasını sakla: Git bilmeden veya özel Git deposuyla yedekleme.

Nasıl çalışır?

flowchart TB
    A["Sen ve AI ajanın"] -->|"Bilgiyi kaydet"| B["Yerel Markdown notları"]
    B -->|"Yerel arama"| C["İlgili notlar ve kaynakları"]
    C -->|"Sonraki oturumda bağlam"| A

Asıl kaynak dosyaların. Beyin bunların yerel indeksini tutar ve seçilen bağlamı kullandığın AI istemcisine verir. Sohbet geçmişinin tamamını kendiliğinden bilgiye dönüştürmez; kalıcı olmasını istediğin şeyi nota yazdırırsın.

V3.13.0'da yeni: Yakala'dan isteğe bağlı Claude/Codex'e gönderim, Word (.docx) belgelerini okuma, Pi bağlantısı ve OpenCode global köprüsü. Yerel web görünümü ve çalışma alanı araçları da bu sürümde. Tüm yenilikler.

Üç adımda kurulum

Gerekenler: Python 3.11+ ve desteklenen bir AI istemcisi. İstemcinin kurulumu ve hesabı ayrı gerekir. Beyin'in temel kurulumu için Git, pip, Mem0 hesabı, ek API anahtarı veya sürekli açık sunucu gerekmez. Obsidian isteğe bağlıdır.

1. Bir klasör seç

Yeni bir klasör veya mevcut Obsidian vault'un olabilir. Notlarını başka yere taşıman gerekmez.

2. AI istemcinde o klasörü aç

Claude Code, Codex veya aşağıdaki istemcilerden birini kullan. Kurulumu istediğin klasörde çalıştığından emin ol.

3. Bu mesajı yapıştır

https://avenox.io/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 indirir, checksum'u doğrular ve kurulumu kontrol eder. İstemcinin gösterdiği klasör veya hook güven incelemesini tamamla. Ardından aynı klasörde yeni bir oturum aç; Codex'te yeni hook tanımlarını /hooks ekranında incele.

Terminalden kendim kurmak istiyorum
  1. Son sürümden beyin-v3-X.Y.Z.zip ve yanındaki .sha256 dosyasını indir. GitHub'ın Source code arşivini seçme.
  2. ZIP'in SHA-256 değerini yanındaki dosyayla karşılaştır ve paketi aç. Doğrulama adımları.
  3. Açtığın paket klasöründe terminal aç. Vault yolunu kendi not 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"

Kurucu motoru, istemci bağlantılarını ve dört başlangıç skill'ini vault'a yerleştirir. Paket klasörünü açık tutman gerekmez. Vault'u istemcinde aç, güven incelemesini tamamla ve yeni bir oturum başlat. Ayrıntılı kurulum.

İlk 5 dakika

Ajanına sırayla şunları söyle. Bunlar örnek mesajlar; kendi bilgilerinle değiştirebilirsin.

Adım Ajanına söyle
Tanış “Beyin skill'ini kullan. Beni tanımak için birkaç kısa soru sor ve cevaplarımı notlara kaydet.”
Kaydet “Örnek proje için Python seçtim, çünkü ekip Python biliyor. Bunu karar notu olarak kaydet.”
Geri bul Yeni oturum aç: “Örnek projede hangi dili seçmiştik, neden? Kaynak notu göster.”
Görev oluştur “Örnek projenin ilk taslağını hazırlamam için bir görev oluştur.”

Kaydı dosyada, geri çağırmayı yeni oturumda kontrol et. Böylece kendi istemcinde bağlantının çalıştığını da görürsün.

Kurulan dört skill ne yapıyor?
Skill Kullanım
beyin Not bulma, bilgi kaydetme, görev ve iş sonucu oluşturma
beyin-doktor Bağlantı, kayıt ve kurulum sorunlarını kontrol etme
beyin-guncelle Güncelleme, sürüm kontrolü ve geri alma
beyin-kontrol Hafızadaki bilginin hala doğru olup olmadığını denetleme; yalnız sen istediğinde çalışır, onayın olmadan yazmaz

Ortak kaynak .agents/skills içindedir; Claude ve Kiro kendi proje kopyalarını kullanır. Mevcut kişisel skill'ler sessizce ezilmez.

Hangi istemcilerle kullanılır?

İstemci Kurulum sonrası
Claude Code Vault klasöründe yeni oturum aç.
Codex Yeni hook tanımlarını /hooks ile incele; yeni oturum aç.
Google Antigravity Vault'u workspace olarak aç ve klasöre güven. Kurulum
Kiro Hook'ları incele; yeni oturum aç. Rehber
Hermes Agent Profil bağlantısını yap, beyin-v3 eklentisini etkinleştir. Rehber
OpenCode Vault klasöründe aç; eklenti yüklenir. Rehber
OMP / Oh My Pi Vault klasöründe aç; hook yüklenir. Rehber
Pi Extension için proje güvenini onayla; yeni oturum aç. Rehber
DeepSeek Harness (DSH) Yalnız açık context/receipt CLI kullanımı; otomatik teslim doğrulanmadı. Rehber

İstemcilerin hook ve güven akışları farklıdır. Codex Desktop'ta açık skill kullanımı ile otomatik hook teslimi aynı şey değildir; otomatik Desktop akışı henüz doğrulanmış sayılmaz. Gerçek istemci kontrolleri.

Başka proje klasörlerinde çalışırken merkezi beynine erişmek için isteğe bağlı global köprü var.

Bir kaynağı tek tuşla yakala

Video, tweet, makale, mail veya dosyayı gelen kutuna al. Sonra ajanına “yakalananları işle” de; metni çıkarıp notlarına bağlasın.

Bir kez, vault klasöründe:

python3 beyin.py yakala kur
macOS Windows Linux
Control + Option + B Ctrl + Alt + B KDE Plasma'da Ctrl + Alt + B; diğer masaüstleri için rehber

Varsayılan Enter yalnız kartı kaydeder. İstersen Claude Code veya Codex ajan modunu ayrıca açıp Ctrl+Enter ile o kartı ajana gönderebilirsin. Word (.docx) belgeleri desteklenir; YouTube sesini yazıya çevirme gibi ek işler ayrı araçlar gerektirebilir. Yakala rehberi.

Beynine tarayıcıdan bak

Görevlerini, son iş sonuçlarını ve doktor özetini tek ekranda gör. İsteğe bağlı web görünümünü vault klasöründe aç:

python3 beyin.py web ac

Örnek verilerle gerçek Beyin web arayüzünün görev görünümü.

Gerçek arayüz, örnek not ve görevlerle, salt okunur modda görüntülendi. Kişisel veri içermez.

Yalnız bu bilgisayarda açılır; 30 dakika kullanılmazsa kapanır. Kurulum sırasında kendiliğinden başlamaz. Sadece görüntülemek için web ac --read-only kullan. Web rehberi.

Güncelleme ve yardım

Güncellemek için ajanına “beynimi güncelle”, sorun varsa “beyin-doktor ile kontrol et” de. Terminal tercih edersen vault klasöründe:

python3 beyin.py update --check   # Yeni sürümü kontrol et
python3 beyin.py update          # Güncelle
python3 beyin.py doctor          # Kurulumu ve bağlantıları kontrol et

Windows: Bu sayfadaki python3 beyin.py ... komutlarında python3 yerine py -3 kullan.

Yakala kullanıyorsan, güncellemeden sonra python3 beyin.py yakala kur komutunu bir kez daha çalıştır; ayrı kopyalanan dinleyici ve skill de yenilensin. İstemcinde yeni oturum aç. Global köprü kullanıyorsan sürümün yeniden kurulum notlarını da kontrol et.

Kullanıcı notları güncellenen sistem dosyalarından ayrıdır. Yönetilen bir dosyada kendi değişikliğin varsa sessizce ezilmez; çakışma bildirilir. Çevrimdışı güncelleme, rollback ve recover.

Merak edilenler

Notlarım nerede? AI sağlayıcısına ne gider?

Notların yerel Markdown dosyalarında, indeks bu bilgisayarda tutulur. Seçilen bağlam AI istemcine verilir; istemcinin model sağlayıcısı ve hesap koşulları geçerlidir. “Yerel hafıza”, bütün AI konuşmasının çevrimdışı olduğu anlamına gelmez.

Özel not işaretleri Beyin'in bağlam ve web filtrelerini etkiler; dosya erişimi verdiğin bir ajan için işletim sistemi düzeyinde koruma oluşturmaz. Kaynak biçimi ve görünürlük.

Ek maliyet veya sürekli çalışan bir servis var mı?

Temel yerel kontroller model çağırmaz. Ajana yaptırdığın işler ve eklenen bağlam istemcinin normal tüketimine girer. “Ekonomik moda geç” veya “otomatik kontrolleri kapat” diyebilirsin; desteklenen istemciler aynı vault tercihini kullanır.

İstemciler kapalıyken sürekli hafıza tarayan bir servis yoktur. Yakala dinleyicisi ve web görünümü ayrı, isteğe bağlı araçlardır. Sürüm bildirimi günde en fazla bir kez GitHub'ı kontrol eder; not göndermez ve kendiliğinden güncelleme kurmaz. İsteğe bağlı Jev danışmanı varsayılan kapalıdır.

Normal / Ekonomik / Manuel modlar · Jev

Her şeyi hatırlar mı? Eski sohbetlerim ne olur?

Arama yerel kelime eşleştirmesine dayanır; her soruda doğru hatırlama garantisi yoktur. Önemli kararları nota yazdır, gerektiğinde kaynağını açtır. İş sonucu kaydı da ajanın yazdığı bir iddiadır; bağımsız doğrulama yerine geçmez.

Eski sohbet geçmişinin tamamı otomatik alınmaz. İsteğe bağlı sohbet izi ve geçmişten özet çıkarma için chat-trace rehberi, son işlerin özeti için komut rehberi var.

V2'den geliyorum veya vault'u başka bilgisayara taşıyorum

V2'den geçişte aynı kurucuyu mevcut vault üzerinde çalıştırırsın. Notlar ve eski günlükler korunur; tanınan eski otomatik yazıcılar geri alınabilir biçimde devreden çıkarılır. Özelleştirilmiş dosyalar varsa kurucu durup açıklar. V2'nin arka planda model çağıran derleyicisi V3'te çalışmaz.

Vault'u taşımak ve birden çok makinede kullanmak ayrı adımlar gerektirir; çalışma veritabanını sıradan bir eşitlenen dosya gibi paylaşma.

V2 geçişi · Birden çok makine · Tarihsel V2 rehberi

Belgeler ve katkı

Aradığın Rehber
Komutlar, görevler ve son işlerin özeti Komut rehberi
Açılış hafızası, kişilik ve arşivleme Companion
Çalışma alanları ve not bağlantıları V3.13.0 yenilikleri
Teknik mimari ve kaynak biçimi V3 belgeleri · Runtime · Markdown
Neler test edildi? Platform testleri · Gerçek istemciler
Bir hata veya katkı Issue aç · Katkı rehberi

Avenox'un günlük ikinci beyin iş akışlarından geliştirildi. Katkı veren herkese teşekkürler. V2 bilgi derleme fikri için Karpathy'nin bilgi tabanı deseninden yararlanıldı.

avenoxbeyin (avenoxai/avenoxbeyin)

正在搜索数据库…

这是什么?一个面向 AI 智能体的本地记忆系统。它把你的笔记、决策和任务保存为电脑上的纯 Markdown 文件,因此无论是跨会话还是跨 AI 客户端,都能继续使用。
它是应用还是插件?两者都不完全是。它是一组智能体技能、钩子(hooks)和客户端连接,安装到一个文件夹中,这个文件夹就成了你的记忆库。你可以用 Obsidian 或任何文本编辑器打开同一个文件夹。
怎么让它运行起来?选一个新文件夹或你现有的 Obsidian 库,在 Claude Code 或 Codex 中打开,然后粘贴 README 中的安装消息。智能体会下载稳定版本、核对校验和并完成设置。之后在该文件夹中开启一个新会话。
我首先需要准备什么?Python 3.11 或更高版本,以及一个受支持的 AI 客户端(需要自行注册账号并完成设置)。基础设置不需要 API 密钥、Mem0 账号,也不需要常驻服务器。Obsidian 是可选的。
有什么需要注意的坑吗?召回依赖本地关键词匹配,所以相关笔记不一定每次都能找回。不同客户端的钩子行为各不相同,Codex Desktop 中的自动钩子投递尚未经过验证。
它能在哪些系统上运行?macOS、Windows 和 Linux,需要 Python 3.11 或更高版本。在 Windows 上,终端命令中要用 py -3 代替 python3。
一键捕获功能是什么?在你的库文件夹中,macOS 上按 Control + Option + B,Windows 上按 Ctrl + Alt + B,即可把视频、推文、文章、邮件或文件保存到收件箱。然后让智能体处理它。支持 Word 的 .docx 文件。
四个内置技能是什么?beyin 负责搜索和保存笔记与任务,beyin-doctor 检查连接和设置,beyin-guncelle 负责更新和回滚,beyin-kontrol 审计已存储的记忆,且只有在你要求时才会写入。
它会自动记录每一次 AI 对话吗?不会。它只会把你明确保存的内容变成笔记,完整的聊天记录不会自动转换为记忆。
它和只用 Obsidian 有什么区别?Obsidian 是可选的。关键在于,你的智能体通过技能和钩子读写的是同一批 Markdown 文件,因此在一个会话中保存的决策,可以在新会话中找到,也可以在 Codex 等不同客户端中找到。
作者
avenoxai
大小
9.2 MB
星标
480
时长
4个月
提交 · 90 天