Nhà cung cấp bộ nhớ

Hermes Agent cung cấp 8 plugin nhà cung cấp bộ nhớ ngoài cung cấp cho tác nhân kiến thức liên tục, xuyên phiên ngoài MEMORY.md và USER.md tích hợp sẵn. Tại một thời điểm, chỉ một nhà cung cấp bên ngoài có thể hoạt động — bộ nhớ tích hợp luôn hoạt động cùng với nhà cung cấp đó.

Bắt đầu nhanh

Hermes memory setup      # interactive picker + configuration
Hermes memory status     # check what's active
Hermes memory off        # disable external provider

Bạn cũng có thể chọn nhà cung cấp bộ nhớ hoạt động thông qua Hermes plugins → Plugin nhà cung cấp → Nhà cung cấp bộ nhớ.

Hoặc cài đặt thủ công trong ~/.Hermes/config.yaml:

memory:
  provider: openviking   # or Honcho, mem0, hindsight, holographic, retaindb, byterover, supermemory

Nó hoạt động như thế nào

Khi nhà cung cấp bộ nhớ hoạt động, Hermes sẽ tự động:

Chèn ngữ cảnh của nhà cung cấp vào dấu nhắc hệ thống (những gì nhà cung cấp biết)
Tìm nạp trước các ký ức liên quan trước mỗi lượt (nền, không chặn)
Đồng bộ hóa cuộc trò chuyện với nhà cung cấp sau mỗi phản hồi
Trích xuất bộ nhớ vào cuối phiên (dành cho các nhà cung cấp hỗ trợ nó)
Ghi bộ nhớ tích hợp phản chiếu cho nhà cung cấp bên ngoài
Thêm các công cụ dành riêng cho nhà cung cấp để nhân viên có thể tìm kiếm, lưu trữ và quản lý kỷ niệm

Bộ nhớ tích hợp (MEMORY.md / USER.md) tiếp tục hoạt động chính xác như trước. Nhà cung cấp bên ngoài là phụ gia.

Nhà cung cấp có sẵn

Honcho

Mô hình hóa người dùng phiên chéo phiên bản gốc AI với Hỏi đáp biện chứng, tìm kiếm ngữ nghĩa và kết luận liên tục.


Tốt nhất cho	Hệ thống nhiều tác nhân với bối cảnh phiên chéo, liên kết tác nhân người dùng
Yêu cầu	`pip install Honcho-ai` + API key hoặc phiên bản tự lưu trữ
Lưu trữ dữ liệu	Honcho Cloud hoặc tự lưu trữ
Chi phí	Giá Honcho (đám mây) / miễn phí (tự lưu trữ)

Công cụ: Honcho_profile (thẻ ngang hàng), Honcho_search (tìm kiếm ngữ nghĩa), Honcho_context (LLM-tổng hợp), Honcho_conclude (lưu trữ dữ kiện)

Trình hướng dẫn cài đặt:

Hermes Honcho setup        # (legacy command) 
# or
Hermes memory setup        # select "Honcho"

Cấu hình: $Hermes_HOME/Honcho.JSON (cục bộ) hoặc ~/.Honcho/config.JSON (toàn cầu). Thứ tự phân giải: $Hermes_HOME/Honcho.JSON > ~/.Hermes/Honcho.JSON > ~/.Honcho/config.JSON. Xem config reference và Honcho integration guide.

Tùy chọn cấu hình chính

Chìa khóa	Mặc định	Mô tả
`APIKey`	--	Khóa API từ app.Honcho.dev
`baseUrl`	--	URL cơ sở cho Honcho tự lưu trữ
`peerName`	--	Nhận dạng ngang hàng của người dùng
`aiPeer`	khóa máy chủ	Nhận dạng ngang hàng AI (một cho mỗi hồ sơ)
`workspace`	khóa máy chủ	ID không gian làm việc chung
`recaLLMode`	`hybrid`	`hybrid` (tự động tiêm + công cụ), `context` (chỉ tiêm), `tools` (chỉ công cụ)
`observation`	tất cả trên	Boolean `observeMe`/`observeOthers` ngang hàng
`writeFrequency`	`async`	`async`, `turn`, `session` hoặc số nguyên N
`sessionStrategy`	`per-directory`	`per-directory`, `per-repo`, `per-session`, `global`
`dialecticReasoningLevel`	`low`	`minimal`, `low`, `medium`, `high`, `max`
`dialecticDynamic`	`true`	Tự động xử lý theo độ dài truy vấn
`messageMaxChars`	`25000`	Số ký tự tối đa cho mỗi tin nhắn (được chia nhỏ nếu vượt quá)

Honcho.JSON tối thiểu (đám mây)

{
  "APIKey": "your-key-from-app.Honcho.dev",
  "hosts": {
    "Hermes": {
      "enabled": true,
      "aiPeer": "Hermes",
      "peerName": "your-name",
      "workspace": "Hermes"
    }
  }
}

Honcho.JSON tối thiểu (tự lưu trữ)

{
  "baseUrl": "http://localhost:8000",
  "hosts": {
    "Hermes": {
      "enabled": true,
      "aiPeer": "Hermes",
      "peerName": "your-name",
      "workspace": "Hermes"
    }
  }
}

Migrating from XPROTECTX63XPROTECTX

Nếu trước đây bạn đã sử dụng Hermes Honcho setup thì cấu hình của bạn và tất cả dữ liệu phía máy chủ vẫn nguyên vẹn. Chỉ cần kích hoạt lại thông qua trình hướng dẫn thiết lập hoặc đặt thủ công memory.provider: Honcho để kích hoạt lại thông qua hệ thống mới.

Đa tác nhân / Hồ sơ:

Mỗi hồ sơ Hermes có thiết bị ngang hàng Honcho AI của riêng mình trong khi chia sẻ cùng một không gian làm việc -- tất cả hồ sơ đều có cùng một đại diện người dùng, nhưng mỗi tác nhân xây dựng danh tính và quan sát riêng của mình.

Hermes profile create coder --clone   # creates Honcho peer "coder", inherits config from default

--clone làm gì: tạo khối máy chủ Hermes.coder trong Honcho.JSON với aiPeer: "coder", workspace được chia sẻ, peerName kế thừa, recaLLMode, writeFrequency, observation, v.v. vì vậy nó tồn tại trước tin nhắn đầu tiên.Đối với hồ sơ được tạo trước khi Honcho được thiết lập:

Hermes Honcho sync   # scans all profiles, creates host blocks for any missing ones

Điều này kế thừa các cài đặt từ khối máy chủ Hermes mặc định và tạo các đồng nghiệp AI mới cho mỗi cấu hình. Idempotent -- bỏ qua các cấu hình đã có khối máy chủ.

Ví dụ đầy đủ về Honcho.JSON (đa cấu hình)

{
  "APIKey": "your-key",
  "workspace": "Hermes",
  "peerName": "eri",
  "hosts": {
    "Hermes": {
      "enabled": true,
      "aiPeer": "Hermes",
      "workspace": "Hermes",
      "peerName": "eri",
      "recaLLMode": "hybrid",
      "writeFrequency": "async",
      "sessionStrategy": "per-directory",
      "observation": {
        "user": { "observeMe": true, "observeOthers": true },
        "ai": { "observeMe": true, "observeOthers": true }
      },
      "dialecticReasoningLevel": "low",
      "dialecticDynamic": true,
      "dialecticMaxChars": 600,
      "messageMaxChars": 25000,
      "saveMessages": true
    },
    "Hermes.coder": {
      "enabled": true,
      "aiPeer": "coder",
      "workspace": "Hermes",
      "peerName": "eri",
      "recaLLMode": "tools",
      "observation": {
        "user": { "observeMe": true, "observeOthers": false },
        "ai": { "observeMe": true, "observeOthers": true }
      }
    },
    "Hermes.writer": {
      "enabled": true,
      "aiPeer": "writer",
      "workspace": "Hermes",
      "peerName": "eri"
    }
  },
  "sessions": {
    "/home/user/myproject": "myproject-main"
  }
}

Xem config reference và Honcho integration guide.

OpenViking

Cơ sở dữ liệu ngữ cảnh của Volcengine (ByteDance) với hệ thống phân cấp kiến thức kiểu hệ thống tệp, truy xuất theo cấp bậc và trích xuất bộ nhớ tự động thành 6 loại.


Tốt nhất cho	Quản lý kiến thức tự lưu trữ với tính năng duyệt có cấu trúc
Yêu cầu	`pip install openviking` + máy chủ đang chạy
Lưu trữ dữ liệu	Tự lưu trữ (cục bộ hoặc đám mây)
Chi phí	Miễn phí (mã nguồn mở, AGPL-3.0)

Công cụ: viking_search (tìm kiếm ngữ nghĩa), viking_read (theo cấp độ: tóm tắt/tổng quan/đầy đủ), viking_browse (điều hướng hệ thống tệp), viking_remember (lưu trữ dữ kiện), viking_add_resource (nhập URL/tài liệu)

Cài đặt:

# Start the OpenViking server first
pip install openviking
openviking-server

# Then configure Hermes
Hermes memory setup    # select "openviking"
# Or manually:
Hermes config set memory.provider openviking
echo "OPENVIKING_ENDPOINT=http://localhost:1933" >> ~/.Hermes/.env

Các tính năng chính:

Tải ngữ cảnh theo từng cấp: L0 (~100 token) → L1 (~2k) → L2 (đầy đủ)
Trích xuất bộ nhớ tự động trên cam kết phiên (hồ sơ, tùy chọn, thực thể, sự kiện, trường hợp, mẫu)
Lược đồ URI viking:// để duyệt kiến thức theo cấp bậc

Mem0

Trích xuất thực tế LLM phía máy chủ với tìm kiếm ngữ nghĩa, sắp xếp lại và tự động loại bỏ trùng lặp.


Tốt nhất cho	Quản lý bộ nhớ rảnh tay — Mem0 tự động xử lý việc trích xuất
Yêu cầu	Khóa API `pip install mem0ai` +
Lưu trữ dữ liệu	Đám mây Mem0
Chi phí	Giá Mem0

Công cụ: mem0_profile (tất cả bộ nhớ được lưu trữ), mem0_search (tìm kiếm ngữ nghĩa + sắp xếp lại), mem0_conclude (lưu trữ dữ kiện nguyên văn)

Cài đặt:

Hermes memory setup    # select "mem0"
# Or manually:
Hermes config set memory.provider mem0
echo "MEM0_API_KEY=your-key" >> ~/.Hermes/.env

Cấu hình: $Hermes_HOME/mem0.JSON

Chìa khóa	Mặc định	Mô tả
`user_id`	`Hermes-user`	Định danh người dùng
`agent_id`	`Hermes`	Định danh Agent

Nhận thức muộn màng

Bộ nhớ dài hạn với biểu đồ tri thức, độ phân giải thực thể và truy xuất đa chiến lược. Công cụ hindsight_reflect cung cấp khả năng tổng hợp nhiều bộ nhớ mà không nhà cung cấp nào khác cung cấp. Tự động giữ lại toàn bộ lượt hội thoại (bao gồm cả lệnh gọi công cụ) với tính năng theo dõi tài liệu ở cấp phiên.


Tốt nhất cho	Thu hồi dựa trên biểu đồ tri thức với các mối quan hệ thực thể
Yêu cầu	Đám mây: Khóa API từ ui.hindsight.vectorize.io. Cục bộ: Khóa API LLM (OpenAI, Groq, OpenRouter, v.v.)
Lưu trữ dữ liệu	Đám mây Hindsight hoặc PostgreSQL nhúng cục bộ
Chi phí	Định giá nhận thức muộn (đám mây) hoặc miễn phí (cục bộ)

Công cụ: hindsight_retain (lưu trữ với trích xuất thực thể), hindsight_recall (tìm kiếm đa chiến lược), hindsight_reflect (tổng hợp bộ nhớ chéo)

Cài đặt:

Hermes memory setup    # select "hindsight"
# Or manually:
Hermes config set memory.provider hindsight
echo "HINDSIGHT_API_KEY=your-key" >> ~/.Hermes/.env

Trình hướng dẫn thiết lập sẽ tự động cài đặt các phần phụ thuộc và chỉ cài đặt những gì cần thiết cho chế độ đã chọn (hindsight-CLIent cho đám mây, hindsight-all cho cục bộ). Yêu cầu hindsight-CLIent >= 0.4.22 (tự động nâng cấp khi bắt đầu phiên nếu đã lỗi thời).

Giao diện người dùng chế độ cục bộ: hindsight-embed -p Hermes ui start

Cấu hình: $Hermes_HOME/hindsight/config.JSON

Chìa khóa	Mặc định	Mô tả
`mode`	`cloud`	`cloud` hoặc `local`
`bank_id`	`Hermes`	Mã định danh ngân hàng bộ nhớ
`recall_budget`	`mid`	Thu hồi kỹ lưỡng: `low` / `mid` / `high`
`memory_mode`	`hybrid`	`hybrid` (ngữ cảnh + công cụ), `context` (chỉ tự động chèn), `tools` (chỉ công cụ)
`auto_retain`	`true`	Tự động giữ lại lượt hội thoại
`auto_recall`	`true`	Tự động gợi lại ký ức trước mỗi lượt
`retain_async`	`true`	Quá trình giữ lại không đồng bộ trên máy chủ
`tags`	—	Thẻ áp dụng khi lưu giữ kỷ niệm
`recall_tags`	—	Thẻ để lọc khi thu hồi

Xem plugin README để tham khảo cấu hình đầy đủ.

Hình ba chiều

Kho lưu trữ thực tế SQLite cục bộ với tính năng tìm kiếm toàn văn bản FTS5, tính điểm tin cậy và HRR (Biểu diễn giảm ba chiều) cho các truy vấn đại số tổng hợp.| | | |---|---| | Tốt nhất cho | Bộ nhớ chỉ cục bộ với khả năng truy xuất nâng cao, không phụ thuộc bên ngoài | | Yêu cầu | Không có gì (SQLite luôn có sẵn). NumPy tùy chọn cho đại số HRR. | | Lưu trữ dữ liệu | SQLite cục bộ | | Chi phí | Miễn phí |

Công cụ: fact_store (9 hành động: thêm, tìm kiếm, thăm dò, liên quan, lý do, mâu thuẫn, cập nhật, xóa, liệt kê), fact_feedback (xếp hạng hữu ích/không hữu ích giúp rèn luyện điểm tin cậy)

Cài đặt:

Hermes memory setup    # select "holographic"
# Or manually:
Hermes config set memory.provider holographic

Cấu hình: config.yaml dưới plugins.Hermes-memory-store

Chìa khóa	Mặc định	Mô tả
`db_path`	`$Hermes_HOME/memory_store.db`	Đường dẫn cơ sở dữ liệu SQLite
`auto_extract`	`false`	Tự động trích xuất thông tin vào cuối phiên
`default_tRust`	`0.5`	Điểm tin cậy mặc định (0,0–1,0)

Khả năng độc đáo:

probe — thu hồi đại số dành riêng cho thực thể (tất cả sự thật về một người/vật)
reason — truy vấn AND tổng hợp trên nhiều thực thể
contradict - tự động phát hiện các sự kiện xung đột
Chấm điểm tin cậy với phản hồi không đối xứng (+0,05 hữu ích / -0,10 không hữu ích)

Giữ lạiDB

API bộ nhớ đám mây với tìm kiếm kết hợp (Vector + BM25 + Xếp hạng lại), 7 loại bộ nhớ và nén delta.


Tốt nhất cho	Các nhóm đã sử dụng cơ sở hạ tầng của RetainDB
Yêu cầu	Tài khoản RetainDB + khóa API
Lưu trữ dữ liệu	Đám mây RetainDB
Chi phí	$20/tháng

Công cụ: retaindb_profile (hồ sơ người dùng), retaindb_search (tìm kiếm ngữ nghĩa), retaindb_context (ngữ cảnh liên quan đến nhiệm vụ), retaindb_remember (lưu trữ với loại + tầm quan trọng), retaindb_forget (xóa bộ nhớ)

Cài đặt:

Hermes memory setup    # select "retaindb"
# Or manually:
Hermes config set memory.provider retaindb
echo "RETAINDB_API_KEY=your-key" >> ~/.Hermes/.env

ByteRover

Bộ nhớ liên tục thông qua brv CLI — cây kiến thức phân cấp với khả năng truy xuất theo cấp độ (văn bản mờ → tìm kiếm theo hướng LLM). Ưu tiên cục bộ với đồng bộ hóa đám mây tùy chọn.


Tốt nhất cho	Các nhà phát triển muốn có bộ nhớ di động, cục bộ đầu tiên có CLI
Yêu cầu	ByteRover CLI (`npm install -g byterover-CLI` hoặc install script)
Lưu trữ dữ liệu	Cục bộ (mặc định) hoặc ByteRover Cloud (đồng bộ hóa tùy chọn)
Chi phí	Định giá miễn phí (cục bộ) hoặc ByteRover (đám mây)

Công cụ: brv_query (cây kiến thức tìm kiếm), brv_curate (lưu trữ dữ kiện/quyết định/mẫu), brv_status (phiên bản CLI + số liệu thống kê về cây)

Cài đặt:

# Install the CLI first
curl -fSSL https://byterover.dev/install.sh | sh

# Then configure Hermes
Hermes memory setup    # select "byterover"
# Or manually:
Hermes config set memory.provider byterover

Các tính năng chính:

Tự động trích xuất nén trước (lưu thông tin chi tiết trước khi nén ngữ cảnh loại bỏ chúng)
Cây tri thức được lưu trữ tại $Hermes_HOME/byterover/ (theo phạm vi hồ sơ)
Đồng bộ hóa đám mây được chứng nhận SOC2 Loại II (tùy chọn)

Siêu bộ nhớ

Bộ nhớ dài hạn theo ngữ nghĩa với tính năng thu hồi hồ sơ, tìm kiếm ngữ nghĩa, công cụ bộ nhớ rõ ràng và nhập cuộc hội thoại cuối phiên thông qua API biểu đồ Supermemory.


Tốt nhất cho	Thu hồi ngữ nghĩa với việc lập hồ sơ người dùng và xây dựng biểu đồ cấp phiên
Yêu cầu	`pip install supermemory` + API key
Lưu trữ dữ liệu	Đám mây siêu nhớ
Chi phí	Giá siêu bộ nhớ

Công cụ: supermemory_store (lưu ký ức rõ ràng), supermemory_search (tìm kiếm tương tự về ngữ nghĩa), supermemory_forget (quên theo ID hoặc truy vấn phù hợp nhất), supermemory_profile (hồ sơ liên tục + bối cảnh gần đây)

Cài đặt:

Hermes memory setup    # select "supermemory"
# Or manually:
Hermes config set memory.provider supermemory
echo 'SUPERMEMORY_API_KEY=***' >> ~/.Hermes/.env

Cấu hình: $Hermes_HOME/supermemory.JSON

Chìa khóa	Mặc định	Mô tả
`container_tag`	`Hermes`	Thẻ vùng chứa được sử dụng để tìm kiếm và ghi. Hỗ trợ mẫu `{identity}` cho các thẻ có phạm vi hồ sơ.
`auto_recall`	`true`	Chèn bối cảnh bộ nhớ có liên quan trước lượt
`auto_capture`	`true`	Lưu trữ lượt trợ lý người dùng đã được làm sạch sau mỗi phản hồi
`max_recall_results`	`10`	Max nhớ lại các mục để định dạng theo ngữ cảnh
`profile_frequency`	`50`	Bao gồm thông tin hồ sơ ở lượt đầu tiên và mỗi N lượt
`capture_mode`	`all`	Bỏ qua các lượt nhỏ hoặc tầm thường theo mặc định
`search_mode`	`hybrid`	Chế độ tìm kiếm: `hybrid`, `memories` hoặc `documents`
`API_timeout`	`5.0`	Hết thời gian chờ cho SDK và yêu cầu nhập

Biến môi trường: SUPERMEMORY_API_KEY (bắt buộc), SUPERMEMORY_CONTAINER_TAG (ghi đè cấu hình).Các tính năng chính:

Tự động rào cản bối cảnh - loại bỏ các ký ức được nhớ lại từ các lượt đã ghi để ngăn ngừa ô nhiễm bộ nhớ đệ quy
Nội dung hội thoại cuối phiên để xây dựng kiến thức ở cấp biểu đồ phong phú hơn
Thông tin hồ sơ được đưa vào lượt đầu tiên và theo các khoảng thời gian có thể định cấu hình
Lọc tin nhắn tầm thường (bỏ qua "ok", "cảm ơn", v.v.)
Vùng chứa trong phạm vi hồ sơ — sử dụng {identity} trong container_tag (ví dụ: Hermes-{identity} → Hermes-coder) để tách biệt bộ nhớ trên mỗi hồ sơ Hermes
Chế độ nhiều vùng chứa — bật enable_custom_container_tags với danh sách custom_containers để cho phép tác nhân đọc/ghi trên các vùng chứa được đặt tên. Các hoạt động tự động (đồng bộ hóa, tìm nạp trước) vẫn ở trên vùng chứa chính.

Ví dụ về nhiều thùng chứa

{
  "container_tag": "Hermes",
  "enable_custom_container_tags": true,
  "custom_containers": ["project-alpha", "shared-knowledge"],
  "custom_container_instructions": "Use project-alpha for coding context."
}

Hỗ trợ: Discord · support@supermemory.com

So sánh nhà cung cấp

Nhà cung cấp	Lưu trữ	Chi phí	Công cụ	Phụ thuộc	Tính năng độc đáo
Hoan hô	Đám mây	Đã trả tiền	4	`Honcho-ai`	Mô hình người dùng biện chứng
OpenViking	Tự lưu trữ	Miễn phí	5	`openviking` + máy chủ	Phân cấp hệ thống tập tin + tải theo tầng
Mem0	Đám mây	Đã trả tiền	3	`mem0ai`	Trích xuất LLM phía máy chủ
Nhận thức muộn màng	Đám mây/Cục bộ	Miễn phí/Trả phí	3	`hindsight-CLIent`	Sơ đồ tri thức + phản ánh tổng hợp
Hình ba chiều	Địa phương	Miễn phí	2	Không có	Đại số HRR + chấm điểm tin cậy
Giữ lạiDB	Đám mây	$20/tháng	5	`requests`	Nén Delta
ByteRover	Địa phương/Đám mây	Miễn phí/Trả phí	3	`brv` CLI	Trích xuất nén trước
Siêu trí nhớ	Đám mây	Đã trả tiền	4	`supermemory`	Hàng rào bối cảnh + nhập biểu đồ phiên + nhiều vùng chứa

Cách ly hồ sơ

Dữ liệu của mỗi nhà cung cấp được phân lập theo profile:

Nhà cung cấp bộ nhớ cục bộ (Holographic, ByteRover) sử dụng đường dẫn $Hermes_HOME/ khác nhau cho mỗi cấu hình
Nhà cung cấp tệp cấu hình (Honcho, Mem0, Hindsight, Supermemory) lưu trữ cấu hình trong $Hermes_HOME/ để mỗi cấu hình có thông tin xác thực riêng
Nhà cung cấp đám mây (RetainDB) tự động lấy tên dự án trong phạm vi hồ sơ
Nhà cung cấp Env var (OpenViking) được định cấu hình qua tệp .env của mỗi cấu hình

Xây dựng nhà cung cấp bộ nhớ

Xem Developer Guide: Memory Provider Plugins để biết cách tạo của riêng bạn.

Bắt đầu nhanh​

Nó hoạt động như thế nào​

Nhà cung cấp có sẵn​

Honcho​

OpenViking​

Mem0​

Nhận thức muộn màng​

Hình ba chiều​

Giữ lạiDB​

ByteRover​

Siêu bộ nhớ​

So sánh nhà cung cấp​

Cách ly hồ sơ​

Xây dựng nhà cung cấp bộ nhớ​

Bắt đầu nhanh

Nó hoạt động như thế nào

Nhà cung cấp có sẵn

Honcho

OpenViking

Mem0

Nhận thức muộn màng

Hình ba chiều

Giữ lạiDB

ByteRover

Siêu bộ nhớ

So sánh nhà cung cấp

Cách ly hồ sơ

Xây dựng nhà cung cấp bộ nhớ