YourMemory: Bộ nhớ sinh học cho AI ứng dụng đường cong lãng quên Ebbinghaus

YourMemory là một hệ thống bộ nhớ bền vững dành cho các tác nhân AI, được xây dựng dựa trên khoa học về cách con người ghi nhớ và lãng quên thông tin. Thay vì lưu trữ mọi thứ vĩnh viễn như một tủ hồ sơ tĩnh — cách tiếp cận phổ biến hiện nay khiến cửa sổ ngữ cảnh (context window) bị nghẽn do quá nhiều dữ liệu nhiễu — YourMemory áp dụng cơ chế "lãng quên" sinh học tự nhiên.

Build Status

Vấn đề của bộ nhớ AI hiện tại

Hầu hết các thiết lập RAG (Retrieval-Augmented Generation) hiện nay đều gặp thất bại vì chúng đối xử với bộ nhớ giống như một kho lưu trữ tĩnh. Khi mọi bản vá lỗi tạm thời hay quy định bị bỏ rơi đều được lưu trữ mãi mãi, ngữ cảnh sẽ sớm bị nghẽn bởi các "tiếng ồn". Điều này không làm tăng chi phí token mà còn làm suy giảm khả năng suy luận của tác nhân AI.

YourMemory giải quyết vấn đề này bằng cách biến ngữ cảnh thành một chất nền sống động, nơi những thông tin quan trọng sẽ được giữ lại còn những thứ không sử dụng sẽ tự động biến mất.

Version

Cơ chế hoạt động: Lãng quên và Lặp lại

Hệ thống áp dụng đường cong lãng quên Ebbinghaus, một mô hình tâm lý học nổi tiếng về cách con người ghi nhớ.

• Độ bền của ký ức (Memory Strength): Mỗi ký ức được gán một điểm "độ bền". Mỗi lần được truy xuất lại, dữ liệu đó được củng cố và làm phẳng đường cong phân rã (mô phỏng kỹ thuật lặp lại ngắt quãng — spaced repetition).
• Tự động dọn dẹp: Dữ liệu không được sử dụng sẽ dần suy yếu theo thời gian. Khi độ bền giảm xuống dưới ngưỡng 0.05, nó sẽ bị cắt bỏ tự động sau mỗi 24 giờ.

Các loại ký ức khác nhau cũng có tốc độ phân rã khác nhau:

• Strategy (Chiến lược): Các mô hình thành công tồn tại khoảng 38 ngày.
• Fact (Sự thật): Các sở thích và định danh tồn tại khoảng 24 ngày.
• Failure (Thất bại): Các lỗi hoặc vấn đề môi trường cụbi tồn tại ngắn nhất, khoảng 11 ngày.

Tìm kiếm lai: Vector và Đồ thị

Để giải quyết vấn đề "hàng xóm logic", nơi tìm kiếm ngữ nghĩa bỏ sót các nút có liên quan nhưng không tương đồng về từ vựng, YourMemory sử dụng kết hợp hai lớp:

1. Vòng 1 - Tìm kiếm Vector: Sử dụng độ tương đồng cosin (cosine similarity) để tìm các ký ức tương đồng trực tiếp.
2. Vòng 2 - Mở rộng Đồ thị: Sử dụng duyệt đồ thị BFS (Breadth-First Search) từ các kết quả của Vòng 1. Điều này giúp tìm ra các ký ức có liên quan về ngữ cảnh nhưng không dùng chung từ vựng, kết nối qua các cạnh ngữ nghĩa.

Ví dụ: Khi tìm kiếm "Python backend", hệ thống có thể đề xuất "Docker/Kubernetes" dù độ tương đồng vector thấp, vì chúng được kết nối qua đồ thị ngữ cảnh của dự án.

Hiệu năng ấn tượng

License

Khi được kiểm chứng trên bộ dữ liệu chuẩn LoCoMo-10 với 1.534 cặp QA, YourMemory đạt được kết quả vượt trội so với các giải pháp hiện có:

• YourMemory: 59% Recall@5 (kết hợp BM25 + Vector + Đồ thị + Phân rã).
• Zep Cloud: Chỉ đạt 28% trên cùng benchmark.

Không chỉ tăng gấp đôi khả năng hồi nhớ, YourMemory còn giúp cắt giảm khoảng 84% lãng phí token nhờ loại bỏ các ngữ cảnh thừa thãi.

Cài đặt và Tích hợp

YourMemory được xây dựng dưới dạng một máy chủ MCP (Model Context Protocol) ưu tiên xử lý cục bộ (local-first), sử dụng DuckDB và không yêu cầu cơ sở hạ tầng phức tạp.

Cách cài đặt nhanh

Hỗ trợ Python 3.11 trở lên:

pip install yourmemory
yourmemory-setup

Lệnh cài đặt sẽ tải mô hình ngôn ngữ spaCy và khởi tạo cơ sở dữ liệu cục bộ tại ~/.yourmemory/memories.duckdb.

Tích hợp với AI Clients

YourMemory hoạt động seamlessly với các ứng dụng khách hỗ trợ MCP như Claude Desktop, Cursor, Cline (VS Code), và các nền tảng khác.

Ví dụ cấu hình cho Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "yourmemory": {
      "command": "yourmemory"
    }
  }
}

Sau khi cấu hình, bạn chỉ cần sao chép file hướng dẫn sample_CLAUDE.md vào thư mục dự án và chỉnh sửa thông tin. Claude sẽ tự động tuân theo quy trình: Recall (Truy xuất) → Store (Lưu trữ) → Update (Cập nhật) cho mọi nhiệm vụ.

Đóng gói công nghệ

• DuckDB: Kho lưu trữ vector mặc định với độ tương đồng cosin tích hợp.
• NetworkX: Backend đồ thị mặc định.
• sentence-transformers: Mô hình nhúng cục bộ (all-mpnet-base-v2).
• spaCy: Xử lý NLP cho khử trùng lặp và trích xuất tam giác SVO.

Hệ thống cũng hỗ trợ tùy chọn nâng cao sử dụng PostgreSQL với pgvector và Neo4j cho các dự án lớn hoặc làm việc theo nhóm.

YourMemory là một bước đi thú vị trong việc cải thiện trí nhớ dài hạn cho AI, đi theo triết lý rằng "điều gì nên quên" quan trọng ngang hàng với "điều gì nên nhớ".