Hermes Agent adalah agent CLI dari Nous Research yang dirancang untuk endpoint OpenAI-compatible apa pun. Syaratnya sederhana: server harus menyediakan /v1/chat/completions, dan AI Gateway Appverse memenuhinya.
Konfigurasinya ramah pemula karena Hermes menyediakan wizard bawaan. Kamu tidak perlu menyunting file config manual untuk kasus standar.
Sebelum mulai
- Paket AI Gateway aktif (Token Plan atau Pay As You Go). Belum punya? Pilih paket dulu di sini.
- API key aktif dari dashboard gateway.
- Hermes Agent sudah terinstal dengan mengikuti Quickstart di dokumentasi resmi Nous Research.
- Satu Model ID dari tabel harga model.
Langkah integrasi
- 1
Jalankan wizard pemilihan model
Copy API key aktif dari dashboard gateway atau halaman Token Plan, karena wizard akan memintanya. Lalu panggil perintah hermes model di terminal.
Hermes menampilkan daftar provider, dan di situ pilih opsi Custom OpenAI-compatible endpoint.
Terminal hermes model - 2
Isi base URL dan API key
Wizard meminta dua hal. Isi base URL dengan https://ai.appverse.id/v1 dan API key dengan key gateway kamu.
Base URL sudah termasuk /v1, jadi jangan menambahkan path lain di belakangnya. Hermes yang menyusun path /v1/chat/completions secara otomatis.
Nilai yang diisi Base URL : https://ai.appverse.id/v1 API key : API_KEY_KAMU (mulai dengan sk-) - 3
Pilih model dan uji
Terakhir, isi Model ID dari gateway lalu simpan. Kirim satu prompt pendek di Hermes untuk memastikan respons keluar.
Bila kamu ingin memverifikasi koneksi sebelum masuk Hermes, panggil endpoint /v1/models lewat curl. Daftar model yang muncul berarti key dan base URL sudah benar.
Verifikasi opsional curl https://ai.appverse.id/v1/models \ -H "Authorization: Bearer API_KEY_KAMU"
Tips pemakaian
- Setelan provider bisa diubah kapan pun lewat wizard yang sama atau perintah config bawaan Hermes, tanpa perlu instal ulang.
- Key disimpan Hermes di config lokal komputer kamu. Jangan menempelkannya di catatan terbuka atau mengirimkannya lewat chat supaya tidak mudah disalahgunakan orang lain.
- Pantau pemakaian token dari dashboard gateway untuk mengukur berapa kuota yang terpakai per sesi kerja.
Pertanyaan yang sering muncul
Syarat endpoint untuk Hermes Agent apa saja?
Endpoint harus menyediakan /v1/chat/completions dengan autentikasi Bearer. AI Gateway Appverse melayaninya di https://ai.appverse.id/v1.
Di mana API key saya disimpan?
Hermes menyimpan konfigurasi provider di file config lokal di komputer kamu. Jangan bagikan file itu, dan ganti key baru dari dashboard gateway bila kamu menduga key sudah tersebar.
Apakah prompt saya disimpan di gateway?
Tidak. Gateway menerapkan ZDR (Zero Data Retention): prompt dan response tidak disimpan, tidak dibaca, dan tidak dipakai untuk training.
Muncul error 401 saat menghubungkan. Apa yang dicek dulu?
Periksa tiga hal: key sudah di-copy utuh tanpa spasi di ujung, base URL persis https://ai.appverse.id/v1, dan paket gateway kamu masih aktif. Uji cepatnya lewat curl ke /v1/models.