Chuyển đến nội dung chính
Sử dụng CometAPI làm nhà cung cấp model cho Hermes Agent thông qua hỗ trợ endpoint OpenAI-compatible tùy chỉnh của Hermes.

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

  • Git
  • Một tài khoản CometAPI có API key đang hoạt động
  • Một 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 key <COMETAPI_KEY> của bạn.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết CometAPI API key với base URL được hiển thị
2

Cài đặt Hermes Agent

Lệnh sau chạy trình cài đặt chính thức:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Nếu shell hiện tại vẫn chưa nhận ra lệnh hermes, hãy tải lại cấu hình shell:
source ~/.zshrc
# or
source ~/.bashrc
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

1

Lưu CometAPI key của bạn

Mở ~/.hermes/.env và thêm dòng sau:
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes sử dụng OPENAI_API_KEY làm phương án xác thực dự phòng cho các endpoint OpenAI-compatible tùy chỉnh.
2

Cấu hình endpoint CometAPI

Mở ~/.hermes/config.yaml và đảm bảo phần model trông như sau:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
Thay your-model-id bằng một model ID văn bản hiện có từ trang CometAPI Models.
Giữ API key trong ~/.hermes/.env. Không hardcode thông tin bí mật 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.

​
Xác minh

1

Kiểm tra cấu hình

Các lệnh sau xác nhận rằng Hermes có thể đọc cấu hình và API key:
hermes config check
hermes doctor
hermes status
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 thử một cuộc chat thực

Lệnh sau gửi một request thực qua CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
Thiết lập thành công sẽ trả về CONNECTED và không có lỗi auth hoặc endpoint.

​
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, trước tiên hãy dùng trình gỡ cài đặt tích hợp sẵn:
hermes uninstall
Trong trình gỡ cài đặt, chọn Full uninstall để xóa CLI, mục 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, 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: CometAPI API key của bạn
  • Model: một CometAPI text model ID hiện có
Luồng này ghi cùng các thiết lập provider vào config.yaml.