Integrasi Hermes API:
Panduan Penyiapan Lengkap dan Cara Kerjanya

Hermes API adalah antarmuka inti Hermes Agent, yang memungkinkannya terhubung dengan model dan alat serta mengotomatiskan alur kerja. Dalam panduan ini, Anda akan mempelajari cara kerjanya, cara menyiapkannya, dan cara mengintegrasikannya dengan penyedia model seperti Kimi.

Hubungkan Hermes dengan Kimi API

10 menit baca2026-06-16

Apa itu Hermes API?

Hermes API adalah antarmuka inti Hermes Agent yang memungkinkannya terhubung ke model AI dan alat. API ini menangani cara agent mengirim permintaan, merutekan data, dan menerima respons dari penyedia model seperti Kimi. Melalui Hermes API, pengguna dapat mengonfigurasi agent untuk mengotomatiskan alur kerja, menjalankan tugas multi-langkah, dan mengelola proses kompleks tanpa intervensi manual.

Bagaimana cara menyiapkan Hermes API dengan Kimi?

Hermes API mendukung beberapa penyedia model, termasuk Kimi API dari Moonshot AI, melalui antarmuka yang kompatibel dengan OpenAI. Artinya, Anda dapat beralih antarpenyedia tanpa mengubah penyiapan yang sudah ada. Langkah-langkah berikut memandu Anda mengonfigurasi Hermes API agar menggunakan Kimi sebagai penyedia model.

Langkah 1: Instal Hermes Agent

Pertama, instal Hermes Agent menggunakan skrip instalasi resmi:

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

Setelah instalasi, langkah berikutnya bergantung pada output yang ditampilkan di terminal Anda.

Jika Anda melihat prompt impor OpenClaw

Hermes mendeteksi penyiapan OpenClaw yang sudah ada. Ketik Y lalu tekan Enter untuk mengimpor workspace, skill, dan pengaturan agent Anda saat ini. Setelah impor selesai, Anda dapat melanjutkan ke wizard penyiapan.

Tekan y atau N untuk memutuskan apakah akan mengimpor dari OpenClaw Anda.

Jika Anda tidak melihat prompt impor OpenClaw

Setelah instalasi, muat ulang shell Anda agar perintah baru aktif. Jika langkah ini dilewati, error "command not found" dapat muncul saat menjalankan Hermes.

Gunakan salah satu perintah berikut sesuai shell Anda.

Jika Anda menggunakan Bash:

source ~/.bashrc

Jika Anda menggunakan Zsh:

source ~/.zshrc

Langkah 2: Pilih penyedia dan model

Pilih penyedia model saat penyiapan; Kimi/Moonshot didukung. Jika Hermes sudah terinstal, lanjutkan dengan menjalankan

hermes model

Pilih model default. kimi-k2.6 adalah model Kimi paling canggih sejauh ini.

Langkah 3: Aktifkan Kimi API Anda

Sebelum menggunakan Kimi API dengan Hermes Agent, aktifkan Kimi API Key Anda di Kimi Open Platform. Kami merekomendasikan $20+ untuk membuka akses Tier 2, yang mengurangi latensi dan mendukung performa yang lebih stabil untuk tugas kompleks multi-langkah

Langkah 4: Buat Kimi API Key Anda

Buka bagian API Keys di Kimi Open Platform dan klik Create API Key. Ingat untuk menyalin API key Anda dan menyimpannya dengan aman. Karena key hanya ditampilkan sekali saat dibuat

Langkah 5: Masukkan API key Anda

Tempelkan Kimi API key Anda dan hubungkan Hermes Agent.

Langkah 6: Siapkan platform pesan

Pilih platform pesan, atau lewati jika Anda belum yakin.

Langkah 7: Masukkan Y untuk mulai chat

Jalankan Hermes Agent Anda.

Langkah 8: Mulai Hermes untuk pertama kalinya

Jika Anda ingin chat dengan Hermes Agent, jalankan:

hermes

atau untuk antarmuka yang lebih baik:

hermes --tui

Langkah 9: Jalankan tugas pertama Anda

Coba kirim instruksi ke Hermes Agent Anda.

Contoh:

Berapa penggunaan disk saya? Tampilkan 5 folder terbesar.

Error umum integrasi API Hermes Agent dan cara mengatasinya

Saat mengintegrasikan Hermes Agent dengan penyedia model, sebagian besar error berasal dari API key yang salah konfigurasi, identifier model yang keliru, atau batasan khusus penyedia. Berikut masalah yang paling sering terjadi beserta cara mengatasinya.

`/model` hanya menampilkan satu penyedia / tidak bisa beralih penyedia

Penyebab: Perintah /model hanya mencantumkan penyedia yang sudah dikonfigurasi.
Cara memperbaiki: Untuk menambahkan penyedia baru, keluar dari sesi saat ini dan jalankan hermes model dari terminal Anda.

# Exit the Hermes chat session first (Ctrl+C or /quit) # Run the full provider setup wizard hermes model # This lets you: add providers, run OAuth, enter API keys, configure endpoints

API key tidak berfungsi

Penyebab: Key tidak ada, kedaluwarsa, disetel keliru, atau untuk penyedia yang salah.
Cara memperbaiki:

# Check your configuration hermes config show # Re-configure your provider hermes model # Or set directly hermes config set MOONSHOT_API_KEY sk-or-v1-xxxxxxxxxxxx

Model tidak tersedia / model tidak ditemukan

Penyebab: Identifier model mungkin salah atau tidak tersedia pada penyedia Anda saat ini.
Cara memperbaiki:

# List available models for your provider hermes model # Set a valid model hermes config set HERMES_MODEL moonshot/kimi-k2.6

Pembatasan laju (error 429)

Penyebab: Permintaan Anda telah melampaui batas laju yang ditetapkan penyedia.
Cara memperbaiki: Tunggu sejenak sebelum mencoba lagi. Untuk penggunaan berkelanjutan, pertimbangkan untuk meningkatkan paket penyedia, beralih ke model atau penyedia lain, atau menggunakan hermes chat --provider <alternative> untuk merutekan permintaan ke backend lain.

Error Hermes Agent lainnya dan cara mengatasinya

Selain integrasi API, Hermes Agent juga dapat mengalami error lain saat penyiapan, konfigurasi, atau runtime. Masalah ini dapat berupa kegagalan instalasi hingga gangguan perilaku agent. Berikut masalah yang paling umum beserta cara mengatasinya.

`hermes: command not found` setelah instalasi

Penyebab: Shell Anda belum memuat ulang PATH yang diperbarui.
Cara memperbaiki:

# Reload your shell profile source ~/.bashrc # bash source ~/.zshrc # zsh # Or start a new terminal session

Jika masih belum berfungsi, periksa lokasi instalasinya:

which hermes ls ~/.local/bin/hermes

Versi Python terlalu lama

Penyebab: Hermes memerlukan Python 3.11 atau yang lebih baru.
Cara memperbaiki:

python3 --version # Check current version # Install a newer Python sudo apt install python3.12 # Ubuntu/Debian brew install [email protected] # macOS

Installer menangani ini secara otomatis — jika Anda melihat error ini saat instalasi manual, tingkatkan Python terlebih dahulu.

Error izin ditolak saat instalasi

Penyebab: Izin tidak memadai untuk menulis ke direktori instalasi.
Cara memperbaiki:

# Don't use sudo with the installer — it installs to ~/.local/bin # If you previously installed with sudo, clean up: sudo rm /usr/local/bin/hermes # Then re-run the standard installer curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

`sudo` tidak berfungsi melalui gateway pesan

Penyebab: Gateway pesan berjalan tanpa terminal interaktif, sehingga sudo tidak dapat meminta kata sandi.
Cara memperbaiki:
- Hindari sudo dalam pesan — minta agent mencari alternatif
- Jika Anda harus menggunakan sudo, konfigurasikan sudo tanpa kata sandi untuk perintah tertentu di /etc/sudoers
- Atau beralihlah ke antarmuka terminal untuk tugas administratif: hermes chat

Backend Docker tidak tersambung

Penyebab: Daemon Docker tidak berjalan, atau pengguna tidak memiliki izin.
Cara memperbaiki:

# Check Docker is running docker info # Add your user to the docker group sudo usermod -aG docker $USER newgrp docker # Verify docker run hello-world

Alat apa saja yang dapat terhubung ke Hermes API?

Hermes API dirancang untuk bekerja dengan banyak klien AI modern dan alat pengembang yang mendukung format kompatibel OpenAI. Dengan begitu, Hermes mudah dihubungkan ke antarmuka chat dan kerangka kerja aplikasi yang sudah ada tanpa perubahan besar. Berikut beberapa platform yang dapat terhubung dengan Hermes:

Open WebUI

Open WebUI terhubung ke Hermes API melalui endpoint yang bekerja dengan OpenAI dan memungkinkan Anda bercakap-cakap di browser. Platform ini sering digunakan untuk menguji prompt dan melihat respons AI secara real time. Karena itu, Open WebUI menjadi pilihan yang mudah untuk instalasi hosted maupun lokal.

LobeChat

LobeChat terintegrasi dengan Hermes API untuk menghadirkan antarmuka chat modern dengan dukungan berbagai model. Di dalamnya tersedia fitur seperti riwayat chat, pengelolaan sesi, dan pergantian model. Ini membuatnya berguna baik untuk penggunaan santai maupun eksperimen AI.

LibreChat

LibreChat bekerja dengan Hermes API sebagai backend bergaya OpenAI dan menyediakan sistem chat berfitur lengkap. LibreChat mendukung banyak penyedia, pengaturan lanjutan, dan pengelolaan percakapan. Platform ini sering digunakan untuk penyiapan AI yang self-hosted dan dapat disesuaikan.

NextChat

NextChat terhubung ke Hermes API untuk menghadirkan pengalaman chat yang cepat dan ringan. Fokusnya adalah kesederhanaan, dengan penyiapan minimal dan akses cepat ke respons AI. Ini ideal bagi pengguna yang menginginkan antarmuka bersih, performa mulus, dan penggunaan harian yang andal.

ChatBox

ChatBox mendukung Hermes API melalui konfigurasi endpoint kustom untuk penggunaan berbasis desktop. Umumnya, ChatBox digunakan untuk menguji prompt dan mengelola percakapan secara lokal. Desainnya yang sederhana membuatnya mudah digunakan oleh pemula maupun pengembang.

AnythingLLM

AnythingLLM terhubung ke Hermes API untuk membangun sistem AI berbasis dokumen dan asisten pengetahuan. Pengguna dapat mengunggah file dan bercakap-cakap dengan data mereka menggunakan AI. Ini berguna untuk alur kerja privat berbasis data yang membutuhkan fleksibilitas dan kontrol tinggi.

OpenAI SDK (Python / JavaScript)

OpenAI SDK bekerja dengan Hermes API karena mengikuti struktur yang kompatibel dengan OpenAI. Pengembang dapat menggunakan kembali kode yang sudah ada untuk membangun aplikasi dan sistem otomasi. SDK ini memberi kendali penuh atas permintaan dan respons AI, dengan dukungan integrasi yang mulus.

Bagaimana cara kerja Hermes API?

Hermes API dibangun di atas arsitektur yang kompatibel dengan OpenAI, dengan dukungan endpoint /v1/chat/completions dan /v1/responses. Artinya, API ini langsung bekerja dengan OpenAI SDK standar tanpa perlu mengubah kode klien yang sudah ada.

Saat permintaan masuk, Hermes menjalankan sistem agent lengkapnya, mengeksekusi alat yang relevan — seperti terminal, file, web, dan memori — lalu mengembalikan respons terstruktur. Hermes juga mendukung streaming, yang menampilkan progres eksekusi alat secara langsung dan memungkinkan observabilitas frontend di setiap langkah.

Apa saja yang sebenarnya bisa dilakukan dengan Hermes Agent?

Hermes dirancang sebagai sistem agent cerdas yang dapat berpikir, menyusun rencana, dan mengeksekusi tugas, bukan sekadar merespons prompt. Dengan memadukan penalaran, penggunaan alat, dan memori, Hermes dapat menjalankan tindakan nyata. Berikut hal-hal yang dapat dilakukan Hermes dalam penggunaan praktis:

Membangun aplikasi AI

Hermes dapat digunakan untuk membangun aplikasi cerdas yang berfungsi seperti asisten digital, bukan sekadar alat chat dasar. Hermes memahami maksud pengguna dan mengubahnya menjadi tindakan bermakna di dalam aplikasi. Aplikasi tersebut dapat berupa asisten chat, alat produktivitas, atau dasbor cerdas, dengan Hermes menambahkan penalaran dan pengambilan keputusan bertahap untuk meningkatkan fungsi secara keseluruhan.

Menjalankan agent AI otonom

Hermes dapat beroperasi sebagai agent mandiri yang menyelesaikan tugas tanpa arahan pengguna secara terus-menerus. Setelah tujuan diberikan, Hermes memecahnya menjadi langkah-langkah kecil, menyusun proses, lalu mengeksekusi setiap langkah satu per satu. Ini membuatnya cocok untuk tugas kompleks seperti riset, perencanaan, atau pemecahan masalah, karena Hermes terus bekerja hingga tujuan akhir tercapai.

Mengotomatiskan alur kerja dan tugas

Hermes dapat menangani tugas digital berulang dengan mengeksekusi alur kerja terstruktur secara otomatis. Hermes dapat mengelola operasi seperti menyusun data, memproses informasi, atau menghasilkan output tanpa upaya manual di setiap langkah. Dengan begitu, pengguna dapat menghemat waktu, mengurangi pekerjaan berulang, dan menjaga hasil tetap konsisten di berbagai tugas dan proses.

Menghubungkan AI ke alat eksternal dan frontend

Saat menjalankan tugas, Hermes dapat berkomunikasi dengan sistem lain, termasuk program, lingkungan file, dan antarmuka pengguna. Hermes dapat mengirim dan menerima data melalui alat yang terhubung serta menggunakannya selama berjalan. Artinya, keputusan Hermes dapat langsung menghasilkan dampak nyata di sistem dunia nyata, sehingga berguna dalam lingkungan digital yang terintegrasi.

Menggunakan proses AI jangka panjang dengan memori

Kesimpulan

Hermes API menggunakan format kompatibel OpenAI yang sudah familier, sehingga sebagian besar klien dan alat yang ada dapat terhubung tanpa konfigurasi tambahan. Dipadukan dengan penyedia model andal seperti Kimi, Hermes mendapatkan backend yang diperlukan untuk menangani alur kerja nyata. Setelah itu, penyiapan selesai dan siap digunakan.

Hubungkan Hermes dengan Kimi API

FAQ

Apakah Hermes API gratis digunakan?

Hermes Agent bersifat gratis dan open-source. Namun, penggunaan dengan penyedia model eksternal seperti Kimi melibatkan biaya API yang ditagihkan oleh penyedia tersebut. Penyiapan model lokal tidak menimbulkan biaya tambahan selain perangkat keras yang menjalankannya.

Mengapa API key diperlukan?

API key diperlukan untuk mengautentikasi permintaan ke penyedia model Anda, seperti Kimi. Ini memastikan hanya akses resmi yang dapat menggunakan sumber daya model, sekaligus dipakai penyedia untuk melacak penggunaan dan mengelola penagihan.

Bagaimana cara menggunakan Hermes API dengan Python?

Anda dapat menggunakan Hermes API di Python melalui OpenAI SDK atau permintaan HTTP standar. Atur base URL ke endpoint Hermes Anda, masukkan API key, lalu kirim permintaan chat completion seperti saat menggunakan API apa pun yang kompatibel dengan OpenAI.

Bagaimana cara mengintegrasikan Hermes API ke aplikasi saya?

Hubungkan aplikasi Anda ke Hermes API dengan mengonfigurasi base URL, API key, dan nama model di pengaturan Anda. Karena mengikuti format yang kompatibel dengan OpenAI, klien apa pun yang mendukung OpenAI API dapat terintegrasi dengan perubahan minimal.

Anda Mungkin Juga Menyukai