Lunos logoLunos
DokumentasiSDKIntegrasi

Integrasi: Hermes Agent dengan Lunos

Panduan ini menunjukkan cara menghubungkan Hermes Agent ke Lunos menggunakan custom endpoint. Karena Lunos sepenuhnya kompatibel dengan OpenAI, integrasi berjalan tanpa hambatan — memberikan akses ke 100+ model melalui satu API key.

Prasyarat

  • Hermes Agent terinstal di mesin Anda
  • Akun Lunos dan API key
  • Model ID yang tersedia di dashboard Lunos Anda

Langkah 1 — Instal Hermes Agent

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Langkah 2 — Dapatkan API key Lunos

  1. Daftar di lunos.tech (gratis, tanpa kartu kredit)
  2. Buka dashboard → API Keys → buat key baru
  3. Catat base URL: https://api.lunos.tech/v1

Langkah 3 — Arahkan Hermes ke Lunos

Jalankan model selector:

hermes model

Pilih "Custom endpoint (self-hosted / VLLM / etc.)" dari menu, lalu masukkan tiga nilai yang diminta:

Field Nilai
Base URL https://api.lunos.tech/v1
API Key API key Lunos Anda
Model misal openai/gpt-4o, anthropic/claude-sonnet-4-6, google/gemini-2-0-flash

Hermes menyimpan pilihan dan menggunakannya untuk setiap sesi berikutnya. Untuk ganti model, jalankan hermes model lagi.

Langkah 4 — (Opsional) Set via file config

Anda juga bisa mengatur langsung di ~/.hermes/config.yaml:

provider: custom
base_url: https://api.lunos.tech/v1
api_key: YOUR_LUNOS_KEY
model: openai/gpt-4o   # atau model ID Lunos lainnya

Atau menggunakan hermes config set:

hermes config set base_url https://api.lunos.tech/v1
hermes config set model openai/gpt-4o

Langkah 5 — (Opsional) Tambahkan fallback provider

Hermes mendukung rantai fallback provider yang dicoba secara berurutan ketika model utama gagal (rate limit, error server, kegagalan auth):

fallback_providers:
  - provider: custom
    base_url: https://api.lunos.tech/v1
    model: anthropic/claude-sonnet-4-6

Langkah 6 — Jalankan dan tes

hermes --tui

Anda akan melihat banner selamat datang dengan model, tools, dan skills yang tersedia. Jika Hermes belum bisa menyelesaikan chat biasa, pastikan satu percakapan berjalan lancar dulu sebelum menambahkan fitur lain.

Troubleshooting

  • Error 401 — Jalankan ulang hermes model dan masukkan kembali key Lunos dengan teliti; jangan gunakan token console/session.
  • 404 pada request — Periksa kembali model ID sesuai yang didukung Lunos (cek dashboard Lunos).
  • Timeout pada langkah panjang — Set HERMES_STREAM_READ_TIMEOUT=120 (atau lebih tinggi) sebelum menjalankan Hermes.
  • Diagnosa masalah — Jalankan hermes doctor.

Referensi