Hermes Agent adalah agent AI open-source dari Nous Research yang berjalan dari terminal Anda, terhubung ke berbagai penyedia model, mengingat konteks yang berguna antar sesi, dan dapat diperluas dengan tools, skill, gateway perpesanan, serta otomasi. Panduan ini membantu Anda memahami cara menginstal Hermes. Anda tidak perlu menginstal Python atau Node.js secara manual untuk installer standar di macOS atau Windows karena installer resmi sudah menangani dependensi utamanya untuk Anda.
Sebelum Menginstal Hermes Agent
Hermes Agent adalah software berbasis terminal, jadi Anda akan menginstalnya dari command line. Pilih bagian yang sesuai dengan komputer Anda:
macOS: buka Terminal dari Applications > Utilities > Terminal, atau tekan Command + Space lalu cari "Terminal."
Windows: instal WSL2 terlebih dahulu, buka terminal distribusi Linux Anda, lalu ikuti perintah Linux.
Anda juga memerlukan Git. Periksa apakah Git sudah terinstal:
Output yang diharapkan:
Jika Anda melihat git: command not found, instal Git terlebih dahulu:
Jika Anda tidak memiliki Homebrew di macOS, instal Git dari Apple Command Line Tools dengan menjalankan:
Langkah 1: Instal Hermes Agent di macOS atau Windows
Di terminal Anda, salin dan tempel perintah installer resmi:
Installer akan mengunduh Hermes Agent, menyiapkan lingkungan Python-nya, menginstal dependensi yang diperlukan, dan menambahkan perintah hermes ke shell path Anda. Pada instalasi pengguna normal, data Hermes disimpan di ~/.hermes/.
Setelah perintah selesai, muat ulang shell Anda:
Jika Anda menggunakan Zsh, yang umum di macOS, jalankan:
Hasil yang diharapkan:
Sekarang pastikan perintah Hermes Agent sudah tersedia:
Hasil yang diharapkan:
Nomor versi yang tepat dapat berubah seiring pembaruan Hermes Agent.
Langkah 2: Konfigurasikan Penyedia Model Anda
Hermes Agent memerlukan penyedia model sebelum dapat menjawab atau menggunakan tools. Setup termudah untuk pemula bersifat interaktif:
Wizard ini memungkinkan Anda memilih penyedia seperti Kimi/Moonshot. Jangan konfigurasikan routing, fallback, gateway, atau cron sebelum chat dasar berfungsi.
Pilih model default. kimi-k2.6 adalah model Kimi paling canggih sejauh ini.
Jika Anda sudah tahu nilai yang ingin diatur, Anda dapat menggunakan hermes config set. Contohnya:
Jika Anda tidak memiliki api-key, Kimi bisa menjadi pilihan yang menarik.
Langkah 1: 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 bertahap banyak
Langkah 2: Buat Kimi API Key Anda
Buka bagian API Keys di Kimi Open Platform lalu klik Create API Key. Ingat untuk menyalin API key Anda dan menyimpannya dengan aman, karena key tersebut hanya ditampilkan sekali saat dibuat.
Langkah 3: Masukkan API key Anda
Tempel Kimi API key Anda dan hubungkan Hermes Agent.
Langkah 3: Jalankan Hermes Agent
Setelah model dikonfigurasi, jalankan CLI klasik:
Atau coba UI terminal yang lebih baru:
Anda akan melihat layar selamat datang atau prompt yang menampilkan penyedia/model yang Anda pilih. Uji dengan permintaan sederhana:
Berikut tampilan jika berhasil:
Jika Hermes Agent terbuka tetapi menampilkan error model atau autentikasi, jalankan:
Lalu pilih provider Anda lagi dan verifikasi API key atau login OAuth-nya.
Langkah 4: Mengubah Hermes Agent Menjadi Bot
Seperti OpenClaw, Hermes Agent juga bisa berfungsi sebagai bot dan terhubung ke aplikasi chat Anda:
Setelah pengaturan, periksa status gateway:
Gunakan gateway hanya setelah provider model Anda berfungsi di terminal. Jika CLI tidak bisa menyelesaikan chat dasar, bot biasanya akan gagal karena alasan yang sama.
Masalah Umum Instalasi Hermes Agent
hermes: command not found
Penyebab: terminal Anda belum memuat ulang perubahan PATH.
Solusi:
Atau:
Lalu coba:
git: command not found
Penyebab: Git tidak terpasang.
Solusi di Ubuntu, Debian, atau WSL2:
Solusi di macOS dengan Homebrew:
API Key Belum Diatur
Penyebab: Hermes Agent sudah terpasang, tetapi belum ada key provider atau login yang dikonfigurasi.
Solusi:
Atau atur key secara manual:
hermes doctor Melaporkan Konfigurasi Hilang atau Usang
Penyebab: file konfigurasi Anda mungkin belum lengkap setelah pembaruan.
Solusi:
Endpoint Kustom Terhubung tetapi Memberikan Balasan yang Buruk
Penyebab: base URL, nama model, atau panjang konteks salah.
Solusi: uji endpoint tersebut di klien terpisah dulu, pastikan kompatibel dengan OpenAI, dan pastikan model mendukung konteks minimal 64K untuk alur kerja Hermes Agent normal.
Referensi Cepat Perintah
Kesimpulan
Cara termudah untuk memasang Hermes Agent adalah menggunakan installer satu baris resmi, memuat ulang shell Anda, menjalankan hermes model, dan memverifikasi pengaturan dengan satu percakapan nyata plus hermes doctor. Jaga agar pengaturan pertama Anda tetap sederhana: satu mesin, satu provider, satu percakapan yang berfungsi. Setelah asisten dasar Hermes Agent stabil, Anda bisa dengan aman mengembangkannya dengan isolasi Docker, bot gateway, skill, otomatisasi terjadwal, dan provider model kustom.
FAQ
~/.hermes/, dan dapat diperluas dengan skill, memori, tugas terjadwal, serta gateway pesan.hermes model, pilih satu penyedia, seperti Kimi, jalankan hermes, coba satu obrolan biasa, jalankan hermes doctor, lalu pastikan hermes --continue bisa melanjutkan sesi kamu. Setelah itu, tambahkan isolasi Docker, skill, server MCP, suara, cron, atau gateway pesan sesuai kebutuhan.