Skip to main content
Gunakan CometAPI sebagai penyedia model untuk Hermes Agent. Hermes mendukung dua jalur CometAPI dalam panduan ini: endpoint umum yang kompatibel dengan OpenAI untuk sebagian besar model teks dan rute Claude melalui Anthropic Messages.

​
Prasyarat

  • Git
  • Akun CometAPI dengan API key yang aktif
  • Terminal di macOS, Linux, atau WSL2

​
Instalasi

1

Dapatkan API key CometAPI Anda

Masuk ke konsol CometAPI. Klik Add API Key lalu salin API key CometAPI Anda.
Dasbor CometAPI yang menampilkan tombol Add API Key
Detail API key CometAPI dengan base URL yang ditampilkan
2

Instal Hermes Agent

Perintah berikut menjalankan installer resmi:
Jika shell saat ini belum mengenali perintah hermes, muat ulang konfigurasi shell:
Hermes menyimpan config di ~/.hermes/, menautkan perintah hermes di ~/.local/bin, dan mungkin menambahkan ~/.local/bin ke PATH shell Anda.

​
Konfigurasi

Pilih route CometAPI yang sesuai dengan keluarga model:
Jangan konfigurasi Hermes dengan https://api.cometapi.com/v1beta sebagai custom provider Gemini-native. Gunakan konfigurasi Hermes yang kompatibel dengan OpenAI untuk model Gemini. Untuk panggilan API Gemini langsung, gunakan API Gemini generateContent.
1

Simpan kunci CometAPI Anda

Buka ~/.hermes/.env dan tambahkan nilai berikut:
COMETAPI_KEY digunakan oleh named provider Claude. OPENAI_API_KEY menjaga agar fallback endpoint kustom Hermes yang kompatibel dengan OpenAI tetap berfungsi.
2

Konfigurasikan route yang kompatibel dengan OpenAI

Gunakan route ini untuk sebagian besar model teks CometAPI, termasuk model Gemini yang digunakan dari Hermes. Buka ~/.hermes/config.yaml dan pastikan bagian model terlihat seperti ini:
Ganti your-model-id dengan model ID teks saat ini dari halaman Models CometAPI.
Simpan API key di ~/.hermes/.env. Jangan hardcode secret di config.yaml.
Pengaturan ini mengonfigurasi model chat utama. Hermes dapat menggunakan model bantu terpisah untuk tugas seperti vision atau ekstraksi web.
3

Konfigurasikan route Claude Messages

Gunakan route ini saat Anda ingin Hermes memanggil model Claude melalui Anthropic Messages. Buka ~/.hermes/config.yaml dan gunakan named provider:
Ganti your-claude-model-id dengan model ID Claude saat ini dari halaman Models CometAPI.
Pertahankan base_url di https://api.cometapi.com untuk route ini. Hermes menggunakan transport Anthropic Messages dari named provider.

​
Verifikasi

1

Periksa konfigurasi

Perintah berikut mengonfirmasi bahwa Hermes dapat membaca config dan API key:
Jika hermes config check melaporkan opsi yang hilang setelah pembaruan, jalankan hermes config migrate lalu periksa lagi.
2

Jalankan uji chat nyata

Perintah berikut mengirim permintaan nyata melalui CometAPI:
Penyiapan yang berhasil akan mengembalikan CONNECTED dan tidak ada error auth atau endpoint. Saat konfigurasi Claude Messages aktif, ini mengonfirmasi bahwa Hermes dapat menggunakan transport anthropic_messages melalui CometAPI.

​
Konfigurasi opsional

Jika Anda mengganti instalasi Hermes yang lebih lama, gunakan uninstaller bawaan terlebih dahulu:
Di uninstaller, pilih Full uninstall untuk menghapus CLI, entri PATH, dan data ~/.hermes/. Lalu jalankan kembali langkah instalasi dan lanjutkan dengan konfigurasi CometAPI yang sama.
Jika Anda lebih memilih alur interaktif untuk rute yang kompatibel dengan OpenAI, jalankan hermes model dan pilih Custom endpoint.Lalu masukkan nilai berikut:
  • Base URL: https://api.cometapi.com/v1
  • API key: kunci API CometAPI Anda
  • Model: model ID teks CometAPI saat ini
Alur ini menulis pengaturan provider yang kompatibel dengan OpenAI ke dalam config.yaml. Untuk Claude Messages, edit config.yaml secara langsung agar provider bernama tersebut tetap menggunakan transport: anthropic_messages.