Penggunaan dengan Hermes Agent

Hermes Agent adalah autonomous coding agent open-source dari Nous Research — tersedia sebagai aplikasi Desktop (Windows, macOS, Linux) dan CLI. Hermes bisa membaca file, menjalankan terminal, dan mengerjakan tugas di proyek Anda.

Dengan menghubungkan Hermes ke OpenNexus sebagai Custom Endpoint, Anda memakai satu API Key OpenNexus untuk ratusan model, tanpa berlangganan provider bawaan Hermes.

Prasyarat

• Hermes Agent sudah terinstal — unduh Desktop di hermes-agent.nousresearch.com, atau pasang CLI.
• Akun OpenNexus dengan API Key aktif dan saldo mencukupi.
• Model dari halaman Models OpenNexus. Hermes membutuhkan context window minimal 64K token — pilih model seperti Gemini, Claude, atau GPT, bukan model kecil.

Instalasi cepat (opsional)

Windows (PowerShell):

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Linux / macOS / WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Setelah CLI terpasang, muat ulang shell (source ~/.bashrc atau buka ulang PowerShell). Perintah hermes harus tersedia.

Referensi Konfigurasi

Hermes menambahkan /chat/completions ke base URL. Pakai pola yang sama dengan Cline/Cursor — bukan URL penuh seperti VS Code Chat.

Daftar model lengkap ada di dashboard OpenNexus → Model Tersedia.

Jangan mengisi https://api.nexusrouter.xyz/api/v1/opennexus/chat/completions — Hermes akan memanggil path ganda. Jangan menambah /v1 di akhir — path OpenNexus bukan /v1/chat/completions.

Cara A: Wizard hermes model (disarankan)

1. Buka wizard provider

Di terminal (di luar sesi chat), jalankan:

hermes model

Di Hermes Desktop, buka Settings → Providers / Model, lalu tambah provider baru. Efeknya sama: menulis ~/.hermes/config.yaml.

2. Pilih Custom Endpoint

Pilih Custom endpoint (self-hosted / VLLM / etc.) — bukan OpenRouter, OpenAI, atau Nous Portal.

3. Isi Base URL OpenNexus

Pada API base URL, masukkan:

https://api.nexusrouter.xyz/api/v1/opennexus

4. Masukkan API Key

Tempel API Key OpenNexus Anda. Jangan memakai kunci OpenRouter atau OpenAI.

5. Pilih transport dan Model ID

• API mode / transport: chat_completions (Chat Completions).
• Model name: ketik ID dari katalog OpenNexus, misalnya:

google/gemini-2.0-flash
anthropic/claude-3-5-sonnet
openai/gpt-4o

Hermes tidak bisa men-discover daftar model OpenNexus otomatis (GET /models belum tersedia untuk API key). Ketik Model ID secara manual.

Simpan wizard. Konfigurasi tersimpan di ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml).

Cara B: Named provider di config.yaml

Agar OpenNexus muncul sebagai grup bernama di model picker Desktop/TUI, tambahkan blok providers::

model:
  default: google/gemini-2.0-flash
  provider: custom
  base_url: https://api.nexusrouter.xyz/api/v1/opennexus
  api_key: sk-opennexus-YOUR_KEY
 
providers:
  opennexus:
    name: OpenNexus
    api: https://api.nexusrouter.xyz/api/v1/opennexus
    api_key: sk-opennexus-YOUR_KEY
    transport: chat_completions
    default_model: google/gemini-2.0-flash

Ganti sk-opennexus-YOUR_KEY dengan API Key Anda. File ini adalah sumber kebenaran untuk provider dan model — jangan mengandalkan variabel OPENAI_BASE_URL / LLM_MODEL (sudah dihentikan untuk custom endpoint).

Verifikasi

1. Jalankan hermes atau hermes --tui, atau buka jendela chat Hermes Desktop.
2. Banner / dropdown model harus menampilkan provider custom dan Model ID yang Anda set.
3. Kirim pesan uji, misalnya: "Sebutkan direktori kerja saat ini dalam satu kalimat."

Jika konfigurasi benar, Hermes merespons lewat OpenNexus dan pemakaian tercatat di dashboard.

Ganti model di tengah sesi

Di dalam chat Hermes, perintah /model hanya berpindah antar provider yang sudah dikonfigurasi. Untuk ganti model OpenNexus, sebutkan ID-nya:

/model custom:google/gemini-2.0-flash
/model custom:anthropic/claude-3-5-sonnet

Jika Anda memakai named provider opennexus:

/model custom:opennexus:google/gemini-2.0-flash

Jangan memakai /model custom tanpa nama model. Perintah itu memanggil GET /models pada base URL — OpenNexus belum mengekspos endpoint tersebut untuk API key, jadi auto-detect akan gagal.

Untuk menambah provider baru, keluar sesi (Ctrl+C atau /quit) lalu jalankan hermes model lagi.

Troubleshooting

404 atau path aneh seperti /opennexus/chat/completions/chat/completions

Base URL Anda berakhiran /chat/completions. Ubah ke:

https://api.nexusrouter.xyz/api/v1/opennexus

404 ke /opennexus/v1/chat/completions

Anda menambah /v1 seperti server lokal (Ollama/vLLM). Hapus sufiks itu.

401 / API key invalid

Pakai API Key dari dashboard OpenNexus, bukan kunci OpenRouter. Pastikan key belum dinonaktifkan.

402 / insufficient balance

Isi saldo di halaman Transaksi OpenNexus, lalu coba lagi.

Hermes menolak model karena context terlalu kecil

Pilih model dengan context ≥ 64K dari halaman Models. Model kecil atau beberapa model free mungkin ditolak di startup.

/model custom tidak menemukan model

Ketik Model ID lengkap. Auto-discover tidak didukung pada OpenNexus saat ini.

Balasan kosong atau error format

Jalankan hermes doctor, lalu hermes model dan pastikan transport chat_completions, base URL, key, dan Model ID sesuai tabel di atas.

Tips

Hermes membaca banyak file dan menjalankan tool — token per sesi lebih tinggi daripada playground. Pantau saldo di dashboard OpenNexus.

Untuk tugas harian, mulai dari google/gemini-2.0-flash. Simpan model lebih besar seperti anthropic/claude-3-5-sonnet untuk refactor atau reasoning yang berat.

Jangan commit config.yaml yang berisi API Key. Treat %USERPROFILE%\.hermes\ seperti folder rahasia.