Cài đặt và sử dụng plugin chính thức với Hermes Agent

Hermes Official Plugins cung cấp gì

Hermes Official Plugins là bộ sưu tập plugin chính thức dành cho Hermes Agent, được Nous Research duy trì. Mỗi thư mục trong kho lưu trữ chứa một tích hợp độc lập có thể được cài đặt thông qua danh mục plugin của Hermes.

Hermes Agent là một tác nhân AI có khả năng tự cải thiện, lưu giữ thông tin hữu ích qua các phiên, phát triển kỹ năng từ kinh nghiệm và hoạt động thông qua các giao diện như terminal, Hermes Desktop, Telegram, Discord, Slack, WhatsApp và Signal. Công cụ này hỗ trợ nhiều nguồn mô hình, bao gồm Nous Portal, OpenRouter, Anthropic, OpenAI và các endpoint tùy chỉnh.

Dự án giữ các thành phần dùng chung của Hermes trong phần lõi, bao gồm vòng lặp tác nhân, bộ nhớ, kỹ năng, gateway, định tuyến mô hình và môi trường chạy công cụ. Các khả năng dành riêng cho sản phẩm và nhà cung cấp được duy trì dưới dạng plugin riêng biệt.

Vì sao Hermes sử dụng plugin

• Cài đặt gọn hơn: Bạn chỉ cài đặt những tích hợp cần thiết.
• Sửa lỗi độc lập: Plugin có thể nhận bản cập nhật đã được xem xét mà không cần chờ bản phát hành lõi Hermes mới.
• Phân định quyền sở hữu rõ ràng: Nous duy trì các plugin chính thức, còn nhà cung cấp và tác giả độc lập duy trì các plugin cộng đồng.
• Phiên bản đã được xem xét: Các mục trong danh mục được ghim vào những commit đã được xem xét, vì vậy việc cài đặt và cập nhật sử dụng các bản sửa đổi xác định.
• Tải xuống hiệu quả: Hermes chỉ tải thư mục plugin đã chọn thông qua bản sao sparse không blob.

Điều kiện tiên quyết và cài đặt Hermes

Bạn cần cài đặt Hermes Agent hoạt động bình thường trước khi thêm các plugin này. Trên hệ thống được hỗ trợ, hãy chạy tập lệnh cài đặt trong README của Hermes:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Sau khi cài đặt, hãy xác nhận giao diện dòng lệnh khả dụng:

hermes --help

Mỗi plugin có thể có thêm yêu cầu riêng. Ví dụ, Spotify yêu cầu ứng dụng dành cho nhà phát triển Spotify của bạn để đăng nhập, Blender yêu cầu Blender 5.1 trở lên cùng tiện ích bổ sung MCP, còn Snyk yêu cầu Node.js, npm và tài khoản Snyk. Hãy xem thông tin trong danh mục của plugin trước khi cài đặt.

Khám phá danh mục plugin

Danh mục plugin Hermes chứa các tích hợp chính thức và cộng đồng đã được xem xét. Sử dụng lệnh tìm kiếm để duyệt các mục hiện có:

hermes plugins search

Xem thông tin một plugin cụ thể trước khi cài đặt:

hermes plugins info spotify

Mục thông tin mô tả chức năng của plugin, các yêu cầu và commit đã được xem xét mà plugin được ghim vào. Người dùng Hermes Desktop có thể truy cập cùng danh mục tại Capabilities → Plugins.

Cài đặt và cập nhật plugin

1. Tìm kiếm tích hợp bạn muốn:

   

   hermes plugins search

2. Đọc các yêu cầu và siêu dữ liệu:

   hermes plugins info spotify

3. Cài đặt phiên bản đã được xem xét:

   hermes plugins install spotify

4. Khi có bản ghim mới hơn đã được xem xét, hãy cập nhật plugin:

   hermes plugins update spotify

Bản cập nhật tuân theo danh mục để chuyển sang commit tiếp theo đã được xem xét. Bản cập nhật không tự động cài đặt một bản sửa đổi tùy ý từ kho lưu trữ.

Lựa chọn plugin chính thức

Home Assistant

Plugin Home Assistant bổ sung một nền tảng gateway và bốn công cụ để liệt kê các thực thể, đọc trạng thái, liệt kê dịch vụ và gọi dịch vụ. Hermes có thể giám sát event bus, phản hồi các thay đổi trạng thái được chọn, điều khiển thiết bị thông qua REST API và trả lời qua thông báo Home Assistant.

hermes plugins install homeassistant

Các công cụ của plugin là ha_list_entities, ha_get_state, ha_list_services và ha_call_service. Cron job có thể nhắm đến Home Assistant bằng deliver=homeassistant.

Spotify

Plugin Spotify cung cấp các công cụ để điều khiển phát, thiết bị Spotify Connect, hàng đợi, tìm kiếm, danh sách phát, album và thư viện của người dùng.

hermes plugins install spotify
hermes spotify login

Lệnh đăng nhập thực hiện quy trình đăng nhập PKCE loopback bằng ứng dụng dành cho nhà phát triển Spotify của bạn. Cần có Spotify Premium để điều khiển phát nhạc.

Claude Subscription DirectSDK

Nhà cung cấp mô hình thử nghiệm này chạy các lượt xử lý của Hermes thông qua CLI Claude Code chính thức bằng gói đăng ký Claude Pro hoặc Max. Hermes vẫn giữ vòng lặp tác nhân, công cụ, xử lý phê duyệt và thu gọn riêng, trong khi plugin sử dụng tệp nhị phân claude đã xác thực làm máy khách mô hình theo phạm vi yêu cầu.

hermes plugins install claude-subscription-directsdk

Sau khi cài đặt, hãy mở hermes model và chọn Claude Subscription DirectSDK (Experimental). Nếu Claude Code không khả dụng, plugin sẽ từ chối chạy và cung cấp hướng dẫn cài đặt.

Chế độ Kinh doanh Telegram

Chế độ Kinh doanh Telegram biến Hermes thành trợ lý quan sát và chờ phê duyệt cho tài khoản Telegram Business. Trợ lý có thể soạn thư trả lời khách hàng, nhưng mọi thư trả lời đều cần chủ tài khoản phê duyệt trước khi gửi.

hermes plugins install hermes-telegram-business

Memory Wiki

Memory Wiki bổ sung một bảng điều khiển và tab Hermes Desktop, giúp sắp xếp lịch sử phiên cục bộ thành các trang theo chủ đề và nhật ký hằng ngày. Tiện ích cũng cung cấp bảng kiểm tra chỉ đọc cho MEMORY.md và USER.md. Plugin đọc lịch sử cục bộ nhưng không ghi vào đó.

hermes plugins install hermes-memory-wiki

Blender

Plugin Blender kết hợp máy chủ MCP Blender Lab chính thức với một kỹ năng quy trình Blender. Plugin yêu cầu Blender 5.1 trở lên cùng tiện ích MCP, cũng như Git và uv. Plugin hỗ trợ Windows, macOS và Linux.

hermes plugins install blender

Các công cụ Blender chạy Python bên trong Blender. Chỉ sử dụng các quy trình đáng tin cậy và xem xét những thao tác có thể sửa đổi cảnh của bạn.

Snyk

Plugin Snyk sử dụng máy chủ MCP chính chủ của Snyk và bao gồm kỹ năng quy trình snyk-security-scan. Plugin có thể quét mã nguồn, dependency, image container, cấu hình infrastructure-as-code và bảng kê vật liệu phần mềm.

hermes plugins install snyk

Plugin yêu cầu Node.js, npm và tài khoản Snyk. Việc xác thực được thực hiện qua trình duyệt bằng snyk_auth.

TouchDesigner

Plugin TouchDesigner kết nối với một phiên TouchDesigner đang hoạt động thông qua máy chủ MCP twozero miễn phí của 404.zero, chạy bên trong TouchDesigner. Plugin bao gồm một kỹ năng quy trình và hơn 20 tệp tham khảo về các chủ đề như operator, GLSL, dự án phản hồi âm thanh và instancing.

hermes plugins install touchdesigner

TouchDesigner được hỗ trợ trên macOS và Windows.

Accent Picker

Accent Picker là plugin Hermes Desktop bổ sung vòng màu OKLCH vào thanh trạng thái. Kéo bộ chọn sẽ đổi màu chủ đề theo thời gian thực, cho phép tác giả chủ đề kiểm thử màu nhấn ngay tại chỗ. Màu được chọn là trạng thái tạm thời và không được lưu lại.

hermes plugins install accent-picker

Di chuyển bản cài đặt cũ

Một số plugin chính thức trước đây nằm trong Hermes core hoặc các repository riêng. Cách di chuyển cần thiết phụ thuộc vào phương thức bạn đã dùng để cài đặt chúng.

• Home Assistant hoặc Spotify tích hợp sẵn: Chạy hermes update. Lần khởi động đầu tiên sau khi cập nhật có thể cài đặt plugin từ catalog mà vẫn giữ nguyên cấu hình, biến môi trường và thông tin đăng nhập hiện có.
• Cài đặt từ catalog: Chạy hermes plugins update <name>. Catalog hiện trỏ đến repository plugin chính thức và giữ lại các tệp của bạn trong quá trình di chuyển.
• Cài đặt dựa trên URL: Cài đặt lại một lần từ catalog bằng hermes plugins install <name> --force. Việc này cần thiết vì các repository độc lập cũ đã được lưu trữ và không còn nhận bản sửa lỗi.

Tìm hiểu cấu trúc repository

Mỗi thư mục plugin cấp cao nhất là một package hoàn chỉnh. Các plugin Python thường chứa manifest, mã đăng ký, dependency và bài kiểm thử. Plugin dựa trên MCP có tính di động có thể sử dụng plugin.json, mcp.json và một thư mục skills, trong khi plugin Desktop có thể bao gồm JavaScript bên trong thư mục desktop.

hermes-official-plugins/
├── assets/
├── homeassistant/
│   ├── plugin.yaml
│   ├── __init__.py
│   ├── pyproject.toml
│   └── tests/
├── blender/
├── accent-picker/
└── ...

Catalog xác định một plugin bằng repository, thư mục con và commit được ghim. Vì vậy, cài đặt Spotify sẽ không tải xuống plugin Home Assistant.

Kiểm thử plugin cục bộ

Để phát triển, hãy clone Hermes Agent và repository plugin chính thức cạnh nhau:

git clone https://github.com/NousResearch/hermes-agent
git clone https://github.com/NousResearch/hermes-official-plugins
cd hermes-official-plugins/spotify
HERMES_AGENT_REPO=../../hermes-agent PYTHONPATH=../../hermes-agent python -m pytest -q

Các plugin chính thức được kiểm thử với Hermes core hiện tại trên Linux, macOS và Windows trong mỗi lần push và pull request. Kiểm thử hằng đêm cũng được sử dụng để phát hiện các thay đổi trong core làm hỏng plugin.

Để cài đặt bản checkout cục bộ vào môi trường Hermes đang hoạt động, hãy truyền đường dẫn thư mục và buộc thay thế:

hermes plugins install ./spotify --force

Mẹo nâng cao

• Kiểm tra trước khi cài đặt: Dùng hermes plugins info <name> để kiểm tra các phần phụ thuộc và commit đã được đánh giá.
• Ưu tiên tên trong danh mục: Cài đặt từ danh mục sẽ theo sát các phiên bản cố định đã được đánh giá trong tương lai hơn so với cài đặt trực tiếp qua URL.
• Sử dụng force cẩn thận: Tùy chọn --force hữu ích cho việc di chuyển và kiểm thử cục bộ, nhưng hãy xác minh rằng bạn đang thay thế đúng bản cài đặt mong muốn.
• Tôn trọng ranh giới phê duyệt: Các plugin như Telegram Business Mode cố ý yêu cầu phê duyệt trước khi gửi phản hồi.
• Đánh giá các tích hợp mạnh: Những công cụ thực thi mã trong ứng dụng, chẳng hạn như Blender, chỉ nên được sử dụng trong các quy trình đáng tin cậy.
• Báo cáo sự cố đúng kho lưu trữ: Mở các sự cố riêng của plugin trong kho lưu trữ plugin chính thức và đưa tên plugin vào tiêu đề, chẳng hạn như [spotify] .... Báo cáo các vấn đề cốt lõi trong trình theo dõi sự cố của Hermes Agent.

Phát hành và xây dựng plugin

Đối với người duy trì, việc hợp nhất thay đổi plugin vào nhánh main của kho lưu trữ không tự động cập nhật người dùng danh mục. Một bản phát hành được hoàn tất bằng cách mở pull request trên Hermes Agent và thay đổi giá trị sha: của plugin trong plugin-catalog/<name>.yaml. Phiên bản cố định trong danh mục đóng vai trò là phiên bản phát hành.

Để tạo tích hợp của riêng bạn, hãy bắt đầu với hướng dẫn plugin Hermes và các plugin mẫu. Plugin tiêu chuẩn là các gói Python thuần túy với tệp kê khai plugin.yaml. Các plugin hoàn thiện có thể được gửi đến danh mục Hermes để đánh giá.

Kết luận

Hermes Official Plugins cung cấp một cách có kiểm soát để mở rộng Hermes Agent mà không đưa mọi tích hợp vào phần lõi. Hãy tìm kiếm trong danh mục, kiểm tra các yêu cầu của plugin, cài đặt phiên bản cố định đã được đánh giá và dùng lệnh cập nhật để chuyển sang các phiên bản sửa đổi mới hơn đã được đánh giá. Nhà phát triển cũng có thể sao chép kho lưu trữ, chạy các bài kiểm thử riêng của plugin và cài đặt các thư mục cục bộ để kiểm thử trong thực tế.