Skip to main content
Sử dụng CometAPI làm nhà cung cấp model cho Hermes Agent. Hermes hỗ trợ hai cách dùng CometAPI trong hướng dẫn này: một endpoint tương thích OpenAI chung cho hầu hết các model văn bản và một tuyến Claude thông qua Anthropic Messages.

​
Điều kiện tiên quyết

  • Git
  • Tài khoản CometAPI với API key đang hoạt động
  • Terminal trên macOS, Linux hoặc WSL2

​
Cài đặt

1

Lấy CometAPI API key của bạn

Đăng nhập vào bảng điều khiển CometAPI. Nhấp vào Add API Key và sao chép CometAPI API key của bạn.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết API key của CometAPI với base URL được hiển thị
2

Cài đặt Hermes Agent

Lệnh sau sẽ chạy trình cài đặt chính thức:
Nếu shell hiện tại vẫn chưa nhận thấy lệnh hermes, hãy tải lại cấu hình shell:
Hermes lưu cấu hình trong ~/.hermes/, liên kết lệnh hermes trong ~/.local/bin, và có thể thêm ~/.local/bin vào PATH của shell.

​
Cấu hình

Chọn route CometAPI khớp với họ model:
Không cấu hình Hermes với https://api.cometapi.com/v1beta như một provider Gemini-native tùy chỉnh. Hãy sử dụng cấu hình Hermes tương thích OpenAI cho các model Gemini. Đối với lệnh gọi Gemini API trực tiếp, hãy dùng Gemini generateContent API.
1

Lưu khóa CometAPI của bạn

Mở ~/.hermes/.env và thêm các giá trị sau:
COMETAPI_KEY được dùng bởi provider Claude được đặt tên. OPENAI_API_KEY giúp cơ chế dự phòng endpoint tùy chỉnh tương thích OpenAI của Hermes tiếp tục hoạt động.
2

Cấu hình route tương thích OpenAI

Sử dụng route này cho hầu hết các model văn bản CometAPI, bao gồm cả các model Gemini được dùng từ Hermes. Mở ~/.hermes/config.yaml và đảm bảo phần model trông như sau:
Thay your-model-id bằng một model ID văn bản hiện có từ trang Models của CometAPI.
Giữ khóa API trong ~/.hermes/.env. Không hardcode secret trong config.yaml.
Thiết lập này cấu hình model chat chính. Hermes có thể sử dụng các model phụ trợ riêng cho những tác vụ như vision hoặc trích xuất web.
3

Cấu hình route Claude Messages

Sử dụng route này khi bạn muốn Hermes gọi các model Claude thông qua Anthropic Messages. Mở ~/.hermes/config.yaml và sử dụng một provider được đặt tên:
Thay your-claude-model-id bằng một model ID Claude hiện có từ trang Models của CometAPI.
Giữ base_url là https://api.cometapi.com cho route này. Hermes sử dụng transport Anthropic Messages từ provider được đặt tên.

​
Xác minh

1

Kiểm tra cấu hình

Lệnh sau xác nhận rằng Hermes có thể đọc config và khóa API:
Nếu hermes config check báo thiếu tùy chọn sau một lần cập nhật, hãy chạy hermes config migrate rồi kiểm tra lại.
2

Chạy kiểm tra chat thực tế

Lệnh sau gửi một request thực tế qua CometAPI:
Thiết lập thành công sẽ trả về CONNECTED và không có lỗi auth hoặc endpoint. Khi cấu hình Claude Messages đang hoạt động, điều này xác nhận rằng Hermes có thể sử dụng transport anthropic_messages thông qua CometAPI.

​
Cấu hình tùy chọn

Nếu bạn đang thay thế một bản cài đặt Hermes cũ hơn, hãy dùng trình gỡ cài đặt tích hợp sẵn trước:
Trong trình gỡ cài đặt, chọn Gỡ cài đặt hoàn toàn để xóa CLI, mục nhập PATH và dữ liệu ~/.hermes/. Sau đó chạy lại bước cài đặt và tiếp tục với cùng cấu hình CometAPI.
Nếu bạn muốn dùng luồng tương tác cho tuyến OpenAI-compatible, hãy chạy hermes model và chọn Custom endpoint.Sau đó nhập các giá trị sau:
  • Base URL: https://api.cometapi.com/v1
  • API key: khóa API CometAPI của bạn
  • Model: một model ID model văn bản CometAPI hiện tại
Luồng này ghi cài đặt provider OpenAI-compatible vào config.yaml. Với Claude Messages, hãy chỉnh sửa trực tiếp config.yaml để provider đã đặt tên vẫn giữ transport: anthropic_messages.