A. Pendahuluan

Hermes Agent merupakan AI Agent Framework yang dikembangkan oleh Nous Research untuk membangun asisten AI yang mampu berinteraksi dengan berbagai Large Language Model (LLM). Hermes Agent mendukung penggunaan API yang kompatibel dengan OpenAI sehingga dapat diintegrasikan dengan berbagai AI Provider.

Pada implementasi ini, 9Router Proxy digunakan sebagai AI Gateway yang menyediakan endpoint OpenAI-Compatible API. Dengan menggunakan 9Router, administrator dapat mengelola beberapa provider AI seperti OpenAI, Gemini, Claude, DeepSeek, maupun OpenRouter melalui satu endpoint terpusat.

Dokumen ini menjelaskan proses konfigurasi Hermes Agent agar dapat terhubung ke layanan AI melalui 9Router Proxy.

B. Instalasi/Konfigurasi

1. Persiapan Sistem

Pastikan server telah memenuhi kebutuhan berikut:

Verifikasi versi Python:

python3 --version

Contoh output: 

Python 3.10.12

2. Verifikasi Status 9Router Proxy

Akses dashboard 9Router melalui browser:

http://IP-SERVER:20128/dashboard

Pastikan dashboard dapat diakses dengan normal.

Masuk ke menu:

Endpoint & Key

Pastikan tersedia API Endpoint seperti berikut:

http://IP-SERVER:20128/v1

Endpoint tersebut akan digunakan oleh Hermes Agent untuk berkomunikasi dengan model AI.

3. Menambahkan Provider AI pada 9Router

Masuk ke menu:

Providers

Pilih Provider yang akan digunakan kemudian Klik Add Connection. Pada document ini kami menggunakan deepseek. 

Contoh provider yang didukung:

• OpenAI
• Gemini
• Claude
• DeepSeek
• OpenRouter
• Grok

Masukkan informasi berikut:

Klik Save.

4. Membuat Combo Provider

Masuk ke menu:

Combos

Klik:

Create Combo

Konfigurasikan:

Klik Save hingga status aktif.

fungsi utama fitur Combos adalah bertindak sebagai "pengatur lalu lintas" untuk aplikasi AI. Daripada Anda repot mengatur banyak model AI secara manual, fitur ini secara otomatis memastikan sistem Anda:

• Selalu hidup (Anti-down): Langsung mengalihkan ke model cadangan jika model utama eror (Fallback).
• Lebih stabil: Membagi rata antrean tugas agar tidak ada model yang kelebihan beban (Round Robin).
• Lebih pintar: Menggabungkan hasil pemikiran dari banyak model untuk mendapatkan jawaban paling sempurna (Fusion).?
• Lebih fleksibel: Otomatis mendeteksi dan mengirim file (gambar/audio/dokumen) ke model yang memang bisa membacanya (Auto-switch).
  
  Intinya: Fitur ini berfungsi untuk memaksimalkan keandalan, kecepatan, dan kualitas aplikasi AI Anda secara otomatis di bawah satu nama pengaturan.

5. Membuat API Key pada 9Router

Masuk ke menu:

Endpoint & Key

Pada bagian API Keys, klik:

Create Key

Isi nama key:

Hermes-Agent

Simpan dan catat API Key yang dihasilkan.

Contoh:

sk-hermes-xxxxxxxxxxxxxxxx

6. Instalasi Hermes Agent

Clone repository Hermes Agent:

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Buat virtual environment:

python3 -m venv venv
source venv/bin/activate

Install dependency (Optional) :

pip install -r requirements.txt

Apabila menggunakan versi terbaru yang berbasis package:

pip install -e .

7. Konfigurasi Hermes Agent

Buat atau edit file environment:

nano .env

Tambahkan konfigurasi berikut:

OPENAI_API_BASE=http://IP-SERVER:20128/v1
OPENAI_API_KEY=sk-hermes-xxxxxxxxxxxxxxxx

MODEL_NAME=gpt-4o-mini

Keterangan:

Simpan konfigurasi.

8. Menjalankan Hermes Agent

Jalankan Hermes Agent:

Ketik perintah hermes pada terminal 

hermes

atau sesuai entry point yang tersedia pada versi Hermes Agent yang digunakan. Pastikan tidak terdapat error koneksi ke endpoint 9Router.

Jika ada error seperti ketika run hermes dan ada error seperti ini
 

Setup terlebih dahulu hermes nya namun menggunakan API 9router yang kita buat. 

Cara setup nya ada pada reference : Cara Installasi dan Pengguunaan Hermes

hermes setup

9. Verifikasi Koneksi ke 9Router

Lakukan pengujian endpoint menggunakan curl:

curl http://IP-SERVER:20128/v1/models \
-H "Authorization: Bearer sk-hermes-xxxxxxxxxxxxxxxx"

Apabila berhasil, sistem akan menampilkan daftar model yang tersedia.

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o-mini"
    }
  ]
}

C. Hasil Uji Coba / Langkah-Langkah

Pengujian Hermes Agent

• Jalankan Hermes Agent.
• Pastikan proses startup berjalan normal.
• Verifikasi koneksi ke endpoint 9Router.
• Lakukan pengujian prompt ke model AI.
   

Hasil Pengujian

D. Kesimpulan/Penutup

Hermes Agent berhasil diintegrasikan dengan 9Router Proxy menggunakan endpoint OpenAI-Compatible API yang disediakan oleh 9Router. Dengan konfigurasi ini, Hermes Agent dapat mengakses berbagai AI Provider melalui satu endpoint terpusat sehingga pengelolaan layanan AI menjadi lebih sederhana dan fleksibel.

Implementasi 9Router sebagai AI Gateway juga memberikan kemudahan dalam pengaturan provider, pengelolaan API Key, monitoring penggunaan, serta penerapan mekanisme failover antar provider AI. Dengan demikian, Hermes Agent dapat digunakan secara lebih optimal dalam lingkungan produksi maupun pengembangan aplikasi berbasis AI.

Semoga artikel yang telah kami sampaikan dapat membantu Anda. Anda juga dapat menemukan artikel lainnya melalui halaman Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala teknis terkait dengan layanan Biznet GIO, Anda dapat menghubungi kami melalui  email support@biznetgio.com atau dapat melalui live chat di website Biznet GIO, melalui chat WhatsApp dan bisa juga melalui telepon ke nomor (021) 5714567.