Hermes Agent

Hermes Agent adalah AI agent coding andal buatan Nous Research yang dirancang untuk bekerja secara mandiri langsung di terminal atau background sistem Anda. Hermes Agent memiliki kemampuan penuh dalam mengeksekusi terminal, mengutak-atik file, mendesain diagram, melakukan deployment, hingga mengoperasikan komputer di background.

Dengan menghubungkan Hermes Agent ke gateway KoboiLLM, Anda dapat menjalankan agent coding mandiri ini menggunakan model unggulan berkinerja tinggi (seperti GPT-5.6 Sol, Terra, atau Luna) dengan latensi super cepat, perlindungan budget ketat, dan prompt caching yang menghemat biaya transaksi Anda hingga 90%.

Langkah 1: Persiapan API Key KoboiLLM

Buka dashboard KoboiLLM Anda, masuk ke menu Virtual Keys → Create New Key.
Berikan nama key (misal: hermes_agent_key), pilih akses All Team Models, gunakan tipe Default, lalu klik Create Key.
Salin Virtual Key yang muncul (contoh format: sk-xxxxxx).

Langkah 2: Metode Konfigurasi Hermes Agent

Anda memiliki dua opsi mudah untuk mendaftarkan KoboiLLM sebagai provider kustom di Hermes Agent Anda.

Metode A: Melalui CLI Wizard Interaktif (Sangat Mudah)

Jalankan perintah manajemen model di terminal lokal Anda:
Terminal window
```
hermes model
```
Pilih opsi Custom Endpoint dari daftar menu yang muncul.
Ikuti onboarding wizard interaktif dengan memasukkan parameter berikut:
- Base URL: https://api.koboillm.com/v1
- API Key: Masukkan Virtual Key KoboiLLM Anda (sk-xxxxxx).
- Model Name: Ketik model default yang ingin dijalankan (contoh: openai/gpt-5.6-terra).
- Context Length: Masukkan 1050000 (atau biarkan kosong untuk deteksi otomatis).
- Supports Vision: Ketik y (karena model GPT-5.6 KoboiLLM mendukung input gambar secara native).

Metode B: Konfigurasi Manual via `config.yaml` (Rekomendasi Developer)

Jika Anda ingin menyimpan konfigurasi secara permanen dan aman, Anda dapat menambahkannya langsung ke file konfigurasi global Hermes Agent.

Buka file konfigurasi global Hermes Agent di text editor Anda:
- Linux / macOS: ~/.hermes/config.yaml
- Windows: %USERPROFILE%\.hermes\config.yaml
Masukkan konfigurasi Custom Provider KoboiLLM berikut:

custom_providers:
  - name: koboillm
    base_url: https://api.koboillm.com/v1
    key_env: KOBOILLM_API_KEY
    api_mode: chat_completions

model:
  default: openai/gpt-5.6-terra
  provider: custom:koboillm
  supports_vision: true

Simpan API Key KoboiLLM Anda ke file environment variables rahasia milik Hermes Agent agar tidak bocor ke Git:
- Buka file: ~/.hermes/.env
- Masukkan baris berikut:
```
KOBOILLM_API_KEY=sk-xxxxxx
```

Langkah 3: Menjalankan Hermes Agent

Setelah konfigurasi selesai, verifikasi konektivitas dengan memanggil status kesehatan Hermes Agent:

hermes doctor

Jika status menunjukkan sehat (Healthy), luncurkan Hermes Agent untuk mulai melakukan tugas-tugas coding otomatis Anda:

hermes

Tips & Fitur Tingkat Lanjut (Advanced)

1. Mengubah Model secara Dinamis di Tengah Sesi

Anda dapat beralih model secara instan tanpa harus keluar dari sesi aktif Hermes menggunakan perintah /model berkode triple:

# Berpindah ke model penalaran premium (GPT-5.6 Sol) untuk debugging berat
/model custom:koboillm:openai/gpt-5.6-sol

# Berpindah ke model ekonomis (GPT-5.6 Luna) untuk pengerjaan boilerplate cepat
/model custom:koboillm:openai/gpt-5.6-luna

2. Mengaktifkan Mode Emulasi Anthropic (Spesial)

Beberapa integrasi agent eksternal yang dioperasikan Hermes (seperti MCP atau plugins tertentu) mengharuskan format pengiriman dalam protokol Anthropic Messages API.

Karena gateway KoboiLLM secara otomatis menerjemahkan request ini secara native, Anda dapat mengubah tipe komunikasi menjadi anthropic_messages pada config.yaml Anda:

custom_providers:
  - name: koboillm-anthropic
    base_url: https://api.koboillm.com/v1
    key_env: KOBOILLM_API_KEY
    api_mode: anthropic_messages # Menggunakan format Anthropic Messages API