AvenoxBeyin: bộ nhớ AI bền vững — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về avenoxai/avenoxbeyin — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: avenoxbeyin: bộ nhớ AI cục bộ bền vững — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
AvenoxBeyin là hệ thống bộ nhớ AI cục bộ dựa trên các tệp Markdown, giúp bạn lưu quyết định, nhiệm vụ và kết quả làm việc để dùng lại trong những phiên sau. Công cụ hỗ trợ Claude Code, Codex và nhiều AI client khác trên Windows, macOS và Linux. Cài đặt tương đối đơn giản nếu bạn có Python 3.11+ và một AI client được hỗ trợ.
AvenoxBeyin là một hệ thống bộ nhớ cục bộ cho các AI agent, giúp ghi thông tin quan trọng vào những tệp Markdown để bạn tìm lại trong các phiên làm việc sau. Bạn có thể mở cùng thư mục bằng Obsidian hoặc bất kỳ trình soạn thảo văn bản nào.
Công cụ phù hợp với người làm kinh doanh muốn lưu quyết định và kế hoạch, nhân viên văn phòng cần theo dõi việc đang làm, hoặc lập trình viên muốn chuyển giữa Claude Code, Codex và các client khác mà không mất ngữ cảnh. Điểm đáng giá nhất là dữ liệu chính nằm trong thư mục của bạn, không bị khóa vào một AI client duy nhất.
Repo hiện có khoảng 440 sao và 74 fork, dùng giấy phép MIT, ngôn ngữ chính là Python. README cho biết dự án vẫn còn được cập nhật và hỗ trợ Windows, macOS cùng Linux.
avenoxai/avenoxbeyin
AvenoxBeyin biến thư mục Markdown thành bộ nhớ cục bộ dùng chung cho nhiều AI client, giúp lưu và tìm lại ghi chú, quyết định, nhiệm vụ.
I.AvenoxBeyin làm được gì
A.Lưu trí nhớ lâu dài cho AI
AvenoxBeyin ghi những điều bạn muốn giữ lại vào các tệp Markdown cục bộ. Chẳng hạn, bạn có thể yêu cầu lưu một quyết định kỹ thuật, kết quả công việc, thông tin dự án hoặc bước tiếp theo.
Ở phiên sau, AI có thể tìm lại thông tin trong các ghi chú đó và chỉ cho bạn nguồn gốc của nó. Cách này hữu ích hơn việc cố nhớ toàn bộ lịch sử trò chuyện, vì bạn chủ động quyết định nội dung nào trở thành trí nhớ lâu dài.
B.Dùng chung một kho ghi chú cho nhiều AI client
Bạn có thể dùng cùng thư mục với Claude Code, Codex, Google Antigravity, Kiro, Hermes Agent, OpenCode, OMP / Oh My Pi hoặc Pi. Khi đổi client, các ghi chú và nhiệm vụ vẫn nằm trong cùng vault.
Mỗi client có quy trình hook và mức độ hỗ trợ riêng. README lưu ý rằng việc mở skill thủ công trong Codex Desktop không giống với việc tự động giao hook, vì vậy bạn cần kiểm tra luồng của client đang dùng.
C.Tìm lại quyết định và thông tin theo nguồn
AvenoxBeyin có thể tìm các ghi chú liên quan bằng tìm kiếm cục bộ. Khi muốn kiểm tra, bạn có thể yêu cầu AI cho biết đã chọn phương án nào và mở ghi chú nguồn.
Cơ chế này đặc biệt hợp với những việc cần truy vết như lý do chọn công nghệ, kết quả một cuộc trao đổi, hay nội dung đã thống nhất với khách hàng. Tuy vậy, tìm kiếm dựa trên khớp từ cục bộ và không bảo đảm luôn tìm đúng mọi thông tin.
D.Tạo nhiệm vụ và lưu kết quả công việc
Bạn có thể yêu cầu AI tạo nhiệm vụ cho một dự án, ghi lại kết quả vừa hoàn thành hoặc lưu bước tiếp theo. Nhờ đó, mỗi phiên làm việc có thể bắt đầu từ trạng thái gần nhất thay vì phải giải thích lại từ đầu.
E.Thu thập tài liệu vào hộp thư đến
Tính năng “Yakala” cho phép đưa video, tweet, bài viết, email hoặc tệp vào hộp thư đến. Sau đó, bạn nói với agent rằng hãy xử lý các nội dung đã thu thập để agent trích xuất văn bản và liên kết chúng vào ghi chú.
Tính năng này hỗ trợ tài liệu Word .docx. Một số việc bổ sung, chẳng hạn chuyển âm thanh YouTube thành văn bản, có thể cần công cụ riêng.
F.Xem nhiệm vụ bằng giao diện web cục bộ
Bạn có thể bật giao diện web tùy chọn để xem nhiệm vụ, kết quả công việc gần đây và phần tóm tắt của công cụ kiểm tra. Giao diện chỉ mở trên chính máy tính đó, tự đóng sau 30 phút không sử dụng và không tự chạy khi cài đặt.
Có thể mở ở chế độ chỉ đọc nếu bạn chỉ muốn xem thông tin. README mô tả giao diện này là chế độ xem cục bộ, không chứa dữ liệu cá nhân mẫu.
G.Kiểm tra, cập nhật và khôi phục
Bốn skill ban đầu gồm beyin, beyin-doktor, beyin-guncelle và beyin-kontrol. Chúng lần lượt hỗ trợ tìm và ghi nhớ, kiểm tra lỗi, cập nhật hoặc khôi phục, và kiểm tra xem thông tin trong bộ nhớ còn đúng hay không.
beyin-kontrol chỉ chạy khi bạn yêu cầu và không tự ghi thay đổi nếu chưa có sự chấp thuận của bạn. Công cụ cũng có kiểm tra phiên bản, cập nhật ngoại tuyến, rollback và recover.
II.Cần chuẩn bị gì
Bạn cần một máy chạy Windows, macOS hoặc Linux. README yêu cầu Python 3.11 trở lên.
Bạn cũng cần một AI client được AvenoxBeyin hỗ trợ, chẳng hạn Claude Code, Codex, Google Antigravity, Kiro, Hermes Agent, OpenCode, OMP / Oh My Pi hoặc Pi. Việc cài đặt tài khoản và client đó là phần riêng, không nằm trong cài đặt cơ bản của AvenoxBeyin.
Nếu cài theo cách thủ công, bạn cần Git và pip theo phần yêu cầu được README nêu trong hướng dẫn ba bước. Tuy nhiên, README đồng thời nói rằng cài đặt cơ bản không cần tài khoản Mem0, API key bổ sung hoặc một máy chủ luôn chạy.
Obsidian là tùy chọn. Bạn có thể dùng một vault Obsidian hiện có hoặc chọn một thư mục mới rồi mở bằng AI client và trình soạn thảo văn bản bất kỳ.
Không có yêu cầu GPU trong tư liệu được cung cấp. README cũng không yêu cầu một phần cứng đặc biệt nào.
Ghi chú vẫn nằm cục bộ, nhưng phần ngữ cảnh được chọn có thể được gửi cho AI client và nhà cung cấp mô hình theo tài khoản của client đó. “Bộ nhớ cục bộ” không có nghĩa là toàn bộ cuộc trò chuyện đều chạy ngoại tuyến.
III.Cài đặt từng bước
- Chọn vaultTạo hoặc chọn thư mục Markdown/Obsidian để lưu ghi chú
- Mở vault bằng AI clientDùng Claude Code, Codex hoặc client được hỗ trợ
- Gửi yêu cầu cài đặtDán thông điệp cài đặt để agent thiết lập hệ thống
- Kiểm tra phiên đầu tiênLưu một thông tin rồi mở phiên mới để tìm lại
- Cài thủ công nếu cầnTải gói phát hành, kiểm tra checksum và chạy trình cài đặt
A.Chọn thư mục lưu bộ nhớ
Bạn có thể tạo một thư mục mới hoặc dùng vault Obsidian hiện có. README nói rõ bạn không cần di chuyển các ghi chú đang có sang nơi khác.
Hãy chọn thư mục mà bạn có quyền đọc và ghi. Đây sẽ là nơi chứa ghi chú, nhiệm vụ và các thành phần được cài cho AI client.
B.Mở thư mục bằng AI client
Mở đúng thư mục vault bằng Claude Code, Codex hoặc một client được hỗ trợ. Điều quan trọng là client phải làm việc trong chính thư mục bạn muốn cài, không phải một thư mục dự án khác.
Nếu dùng Codex, README yêu cầu sau khi cài phải xem các hook mới trong màn hình /hooks. Với Google Antigravity, bạn mở vault như workspace và xác nhận tin cậy thư mục. Những client khác có luồng xem hook hoặc xác nhận tin cậy riêng.
C.Cài bằng thông điệp cho agent
Trong AI client đang mở đúng vault, dán nguyên thông điệp sau:
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.Thông điệp này yêu cầu agent đọc hướng dẫn chính thức, cài bộ nhớ vào thư mục hiện tại, giữ lại ghi chú nếu đã có cài đặt, rồi lưu một thông tin mẫu và đọc lại trong phiên mới.
Agent sẽ tải gói ổn định, kiểm tra checksum và kiểm tra quá trình cài. Khi client hiển thị yêu cầu tin cậy thư mục hoặc hook, bạn cần hoàn tất bước xem xét đó. Sau đó mở một phiên mới trong cùng vault.
D.Cài thủ công trên macOS hoặc Linux
Nếu không muốn nhờ agent, hãy tải đúng gói beyin-v3-X.Y.Z.zip cùng tệp .sha256 đi kèm từ bản phát hành. README cảnh báo không chọn gói “Source code”. Sau khi kiểm tra SHA-256 và giải nén, mở terminal trong thư mục gói vừa giải nén.
Thay đường dẫn vault bằng thư mục ghi chú thật của bạn:
python3 scripts/install_v3.py --vault "/tam/yol/Beynim"python3 gọi Python 3 trên macOS hoặc Linux. scripts/install_v3.py là trình cài đặt nằm trong thư mục gói. Tùy chọn --vault chỉ nơi đặt bộ nhớ; bạn phải thay /tam/yol/Beynim bằng đường dẫn thật.
Trình cài đặt đặt bộ máy, kết nối client và bốn skill ban đầu vào vault. Bạn không cần giữ thư mục gói mở sau khi cài. Tiếp theo, mở vault trong AI client, hoàn tất kiểm tra tin cậy và bắt đầu phiên mới.
E.Cài thủ công trên Windows
Sau khi tải đúng gói phát hành, tệp checksum và giải nén, mở PowerShell trong thư mục gói vừa giải nén. Dùng đường dẫn Windows của vault:
py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim"py -3 gọi Python 3 trên Windows. Phần sau --vault là thư mục nơi bạn muốn lưu ghi chú. Đừng giữ nguyên C:\Notlar\Beynim nếu đó không phải thư mục của bạn.
Sau khi chạy xong, mở vault trong AI client, xác nhận tin cậy nếu được hỏi và mở một phiên mới. README có riêng tệp hướng dẫn Windows trong repo nếu bạn cần các chi tiết nền tảng bổ sung.
F.Cài tính năng thu thập nguồn
Tính năng “Yakala” được cài một lần trong vault bằng lệnh sau:
python3 beyin.py yakala kurTrên Windows, thay python3 bằng py -3 theo hướng dẫn của README. Sau khi cài, phím tắt mặc định là Control + Option + B trên macOS, Ctrl + Alt + B trên Windows và KDE Plasma. Trên môi trường Linux khác, README yêu cầu xem hướng dẫn riêng.
Nhấn Enter sẽ chỉ lưu thẻ vào hộp thư đến. Nếu bật chế độ agent của Claude Code hoặc Codex, bạn có thể dùng Ctrl+Enter để gửi thẻ đó cho agent.
G.Bật giao diện web tùy chọn
Đứng trong thư mục vault rồi chạy:
python3 beyin.py web acTrên Windows, dùng py -3 beyin.py web ac. Lệnh này mở giao diện web cục bộ để xem nhiệm vụ, kết quả công việc và phần tóm tắt kiểm tra. Nếu chỉ muốn xem, dùng:
python3 beyin.py web ac --read-onlyGiao diện chỉ mở trên máy tính hiện tại. Nó không tự khởi động cùng quá trình cài đặt và sẽ tự đóng nếu không được dùng trong 30 phút.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra rõ nhất là làm đúng chuỗi thử nghiệm mà README đề xuất. Trước tiên, trong phiên hiện tại, nói với agent:
Beyin skill'ini kullan. Beni tanımak için birkaç kısa soru sor ve cevaplarımı notlara kaydet.Agent cần hỏi bạn vài câu ngắn và ghi câu trả lời vào ghi chú. Tiếp theo, yêu cầu lưu một quyết định mẫu:
Örnek proje için Python seçtim, çünkü ekip Python biliyor. Bunu karar notu olarak kaydet.Mở một phiên mới trong cùng vault rồi hỏi:
Örnek projede hangi dili seçmiştik, neden? Kaynak notu göster.Kết quả mong đợi là agent tìm lại Python, lý do đội ngũ đã biết Python, và chỉ ra ghi chú nguồn. Bạn cũng có thể kiểm tra khả năng tạo nhiệm vụ bằng câu:
Örnek projenin ilk taslağını hazırlamam için bir görev oluştur.Nếu client yêu cầu xác nhận hook hoặc quyền tin cậy thư mục, hãy xem xét và hoàn tất bước đó. Với Codex, kiểm tra hook mới bằng /hooks. Nếu muốn kiểm tra kỹ thuật, chạy lệnh doctor trong thư mục vault:
python3 beyin.py doctorTrên Windows:
py -3 beyin.py doctorLệnh này kiểm tra cài đặt và kết nối. Bạn cũng có thể mở giao diện web để nhìn thấy nhiệm vụ và kết quả công việc trên một màn hình.
V.Dùng vào việc thật
A.Chủ shop lưu quyết định nhập hàng
Một chủ shop có thể dùng AI client để ghi lại lý do chọn một dòng sản phẩm, nhóm khách hàng mục tiêu và việc cần làm tiếp theo. Ví dụ, sau khi trao đổi, bạn nói:
Mặt hàng thử nghiệm này nhắm tới khách mua lần đầu. Hãy lưu quyết định nhập thử và tạo nhiệm vụ kiểm tra phản hồi khách hàng.Ở phiên sau, bạn hỏi:
Vì sao chúng ta nhập thử mặt hàng này? Hãy cho tôi xem ghi chú nguồn và nhiệm vụ còn mở.Kết quả là AI tìm trong các ghi chú cục bộ, trả lại quyết định và giúp bạn tiếp tục từ nhiệm vụ đã tạo. Đây là cách phù hợp để không phải lục lại nhiều cuộc trò chuyện.
B.Nhân viên văn phòng theo dõi việc đang làm
Sau một buổi làm việc, bạn có thể yêu cầu agent lưu kết quả và bước tiếp theo:
Hãy lưu kết quả công việc hôm nay, các vấn đề còn mở và bước tiếp theo vào ghi chú công việc.Sang phiên mới, yêu cầu:
Tóm tắt công việc gần nhất và cho tôi biết bước tiếp theo.Bạn có thể mở giao diện web bằng python3 beyin.py web ac để xem nhiệm vụ, kết quả gần đây và phần tóm tắt kiểm tra. Trên Windows dùng py -3 thay cho python3.
C.Lập trình viên đổi từ Claude Code sang Codex
Một lập trình viên có thể lưu quyết định như kiến trúc, ngôn ngữ hoặc lý do chọn thư viện vào vault. Ví dụ:
Dự án mẫu dùng Python vì đội đã quen Python. Hãy lưu đây là một quyết định kỹ thuật và ghi lại lý do.Khi mở cùng vault trong client được hỗ trợ khác, bạn hỏi:
Trong dự án mẫu, chúng ta đã chọn ngôn ngữ nào và lý do là gì? Hãy mở ghi chú nguồn.Ghi chú vẫn ở cùng thư mục Markdown, nên việc đổi client không buộc bạn xây lại toàn bộ trí nhớ. Với Codex, nhớ kiểm tra hook mới bằng /hooks sau khi cài.
D.Thu thập tài liệu để xử lý sau
Khi nhận được một bài viết, email, video hoặc tệp cần đọc, bạn có thể đưa vào hộp thư đến bằng “Yakala”. Sau đó nói:
Yakalananları işle.Agent sẽ xử lý nội dung đã thu thập, trích xuất phần phù hợp và liên kết vào ghi chú theo khả năng của hệ thống. Tệp Word .docx được hỗ trợ. Nếu cần chép lời âm thanh YouTube hoặc một tác vụ bổ sung tương tự, bạn có thể phải cài công cụ riêng.
Điều đáng giá nhất là bạn giữ được quyết định, nhiệm vụ và nguồn ghi chú ngay cả khi đổi AI client.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Agent chạy trong sai thư mục
Nếu cài đặt nhưng không thấy ghi chú trong vault mong muốn, hãy kiểm tra client đang mở thư mục nào. README yêu cầu cài trong thư mục bạn muốn dùng và dùng đúng thư mục đó trong các phiên sau.
Mở lại đúng vault rồi chạy lại quy trình cài đặt hoặc dùng đường dẫn chính xác với tùy chọn --vault.
B.Python không đúng phiên bản
AvenoxBeyin yêu cầu Python 3.11 trở lên. Trên Windows, dùng py -3; trên macOS và Linux, dùng python3 theo lệnh trong README. Nếu lệnh không gọi được Python phù hợp, hãy kiểm tra phiên bản Python trước khi chạy trình cài đặt.
C.Chọn nhầm gói Source code
README yêu cầu tải gói phát hành có tên dạng beyin-v3-X.Y.Z.zip và tệp .sha256 đi kèm, không chọn gói Source code. Nếu chọn sai gói, bạn có thể thiếu cấu trúc hoặc quy trình phát hành mà trình cài đặt mong đợi.
Hãy tải đúng gói phát hành, kiểm tra SHA-256 với tệp đi kèm rồi mới giải nén và cài.
D.Chưa xác nhận hook hoặc quyền tin cậy
Một số client yêu cầu bạn xem xét hook, xác nhận thư mục hoặc bật quyền tin cậy. Nếu bỏ qua, kết nối tự động có thể chưa hoạt động dù tệp đã được đặt vào vault.
Hãy hoàn tất bước xem xét theo client. Với Codex, mở /hooks để kiểm tra hook mới; với client có workspace, hãy xác nhận đúng vault.
E.Mong hệ thống tự nhớ toàn bộ cuộc trò chuyện
AvenoxBeyin không tự biến toàn bộ lịch sử trò chuyện cũ thành trí nhớ. Bạn cần yêu cầu agent ghi những thông tin quan trọng vào ghi chú. Công cụ cũng không bảo đảm mọi lần tìm kiếm đều trả đúng thông tin.
Hãy lưu các quyết định, kết quả và bước tiếp theo một cách có chủ đích, sau đó yêu cầu agent cho xem nguồn khi cần kiểm tra.
F.Cập nhật nhưng quên cài lại Yakala
Nếu đang dùng tính năng thu thập, sau khi cập nhật hệ thống bạn cần chạy lại lệnh cài Yakala để làm mới listener và skill được sao chép riêng:
python3 beyin.py yakala kurTrên Windows dùng py -3 beyin.py yakala kur. Sau đó mở phiên mới trong client.
VII.Có nên dùng không
AvenoxBeyin đáng dùng nếu bạn muốn bộ nhớ AI nằm trong các tệp Markdown, cần chuyển qua lại giữa nhiều client, hoặc muốn kiểm soát việc gì được lưu lâu dài. Cách cài có đường tự động bằng agent và đường thủ công bằng Python, nên phù hợp cả người mới lẫn người muốn tự kiểm tra từng bước. MIT là một điểm thuận lợi nếu bạn muốn dùng một dự án mã nguồn mở.
Điểm mạnh chính là dữ liệu cục bộ, có nguồn ghi chú để truy vết, hỗ trợ nhiều client và không cần Mem0, API key bổ sung hay máy chủ luôn chạy cho phần cài đặt cơ bản. Các tính năng như Yakala, giao diện web, doctor và rollback cũng giúp quy trình sử dụng thực tế dễ quản lý hơn.
Giới hạn cần nhớ là tìm kiếm dựa trên khớp từ cục bộ, không phải hệ thống hiểu biết hoàn hảo. Lịch sử chat cũ không tự động được nhập toàn bộ. Phần ngữ cảnh được chọn vẫn có thể đi qua AI client và nhà cung cấp mô hình, nên bạn cần xem xét quyền truy cập và chính sách tài khoản của client.
Bạn cũng không nên chia sẻ cơ sở dữ liệu làm việc như một tệp đồng bộ thông thường giữa nhiều máy; README nói việc chuyển vault và dùng nhiều máy cần các bước riêng. Nếu bạn chỉ cần ghi chú cá nhân đơn giản, không dùng AI client hỗ trợ, hoặc không muốn cấp quyền thư mục cho agent, một ứng dụng ghi chú thông thường có thể phù hợp hơn.
Câu hỏi thường gặp
AvenoxBeyin có miễn phí không?
Repo dùng giấy phép MIT và phần cài đặt cơ bản không yêu cầu tài khoản Mem0 hay API key bổ sung. Tuy nhiên, các tác vụ AI vẫn có thể tính vào mức sử dụng và điều kiện tài khoản của AI client bạn đang dùng.
Có cần GPU để chạy không?
Tư liệu được cung cấp không nêu yêu cầu GPU. README chỉ nêu hệ điều hành Windows, macOS, Linux, Python 3.11+ và một AI client được hỗ trợ.
Có chạy được trên Windows không?
Có. README có hướng dẫn Windows riêng và dùng lệnh `py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim"`. Sau cài đặt, bạn cần mở vault trong client và hoàn tất kiểm tra tin cậy nếu được yêu cầu.
Dữ liệu có hoàn toàn riêng tư và ngoại tuyến không?
Ghi chú và chỉ mục được lưu cục bộ trên máy. Tuy nhiên, phần ngữ cảnh được chọn có thể được gửi cho AI client và nhà cung cấp mô hình; README nói rõ bộ nhớ cục bộ không đồng nghĩa toàn bộ cuộc trò chuyện chạy ngoại tuyến.
AvenoxBeyin có tự nhớ toàn bộ lịch sử trò chuyện không?
Không. Những nội dung quan trọng cần được bạn yêu cầu agent lưu vào ghi chú. Lịch sử trò chuyện cũ không tự động được nhập toàn bộ, và tìm kiếm cục bộ không bảo đảm luôn tìm đúng mọi thông tin.
Có bắt buộc phải dùng Obsidian không?
Không. Obsidian là tùy chọn. Bạn có thể dùng thư mục mới hoặc vault hiện có, rồi mở bằng AI client hoặc bất kỳ trình soạn thảo văn bản nào.
Có thể dùng chung vault trên nhiều máy không?
Có thể, nhưng README nói việc chuyển vault và dùng nhiều máy cần các bước riêng. Không nên chia sẻ cơ sở dữ liệu làm việc như một tệp đồng bộ thông thường.


