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)

Ищем в базе…

Что это такое?Локальная система памяти для ИИ-агентов. Она хранит ваши заметки, решения и задачи как обычные файлы Markdown на вашем компьютере, поэтому они сохраняются между сессиями и ИИ-клиентами.
Это приложение или плагин?Ни то, ни другое в точности. Это набор навыков агента, хуков и подключений к клиентам, установленных в папку, которая становится вашим хранилищем памяти. Ту же папку можно открыть в Obsidian или любом текстовом редакторе.
Как это запустить?Выберите новую папку или существующее хранилище Obsidian, откройте его в Claude Code или Codex и вставьте установочное сообщение из README. Агент загрузит стабильный релиз, проверит его контрольную сумму и всё настроит. Затем начните новую сессию в этой папке.
Что нужно сначала?Python 3.11 или новее и поддерживаемый ИИ-клиент с его собственной учётной записью и настройкой. Базовая установка не требует ключа API, аккаунта Mem0 и постоянно работающего сервера. Obsidian не обязателен.
Есть подводные камни?Поиск опирается на локальное сопоставление ключевых слов, поэтому нужная заметка не всегда найдётся. Поведение хуков отличается в разных клиентах, а автоматическая доставка хуков в Codex Desktop пока не проверена.
На каких системах это работает?macOS, Windows и Linux, с Python 3.11 или новее. В Windows в командах терминала используйте py -3 вместо python3.
Что такое захват одной клавишей?В папке хранилища нажмите Control + Option + B на macOS или Ctrl + Alt + B на Windows, чтобы сохранить видео, твит, статью, письмо или файл во входящие. Затем попросите агента обработать его. Поддерживаются файлы Word (.docx).
Какие четыре встроенных навыка?beyin отвечает за поиск и сохранение заметок и задач, beyin-doctor проверяет подключения и настройку, beyin-guncelle отвечает за обновления и откат, а beyin-kontrol проверяет сохранённую память, но записывает в неё только по вашему запросу.
Записывает ли он каждый чат с ИИ автоматически?Нет. Он превращает в заметки только то, что вы явно сохранили, а вся история чата автоматически в память не переносится.
Чем он отличается от простого использования Obsidian?Obsidian не обязателен. Суть в том, что ваш агент читает и записывает одни и те же файлы Markdown через навыки и хуки, поэтому решение, сохранённое в одной сессии, можно найти в новой сессии или в другом клиенте, например в Codex.
Автор
avenoxai
Размер
9.2 MB
Звёзды
480
Возраст
4 мес
Коммиты · 90 дней