Hermes Agent adalah agen AI sumber terbuka dari Nous Research yang berjalan dari terminal, terhubung ke berbagai penyedia model, mengingat konteks yang berguna di berbagai sesi, dan dapat diperluas dengan alat, skill, gateway pesan, serta otomatisasi. Panduan ini membantu Anda memahami cara menginstal Hermes. Anda tidak perlu menginstal Python atau Node.js secara manual untuk penginstal standar di macOS atau Windows karena penginstal resmi menangani dependensi utama untuk Anda.
Sebelum Menginstal Hermes Agent
Hermes Agent adalah perangkat lunak yang berfokus pada terminal, jadi Anda akan menginstalnya melalui baris perintah. 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 belum memiliki Homebrew di macOS, instal Git dari Apple Command Line Tools dengan menjalankan:
Langkah 1: Instal Hermes Agent di macOS atau Windows
Di terminal, salin dan tempel perintah penginstal resmi:
Penginstal akan mengunduh Hermes Agent, menyiapkan lingkungan Python-nya, menginstal dependensi yang diperlukan, dan menambahkan perintah hermes ke path shell Anda. Dalam instalasi pengguna biasa, 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 tersedia:
Hasil yang diharapkan:
Nomor versi yang tepat dapat berubah saat Hermes Agent diperbarui.
Langkah 2: Konfigurasikan Penyedia Model Anda
Hermes Agent memerlukan penyedia model sebelum dapat menjawab atau menggunakan alat. Pengaturan termudah bagi pemula adalah secara interaktif:
Wizard memungkinkan Anda memilih penyedia seperti Kimi/Moonshot. Jangan konfigurasi routing, fallback, gateway, atau cron sebelum chat dasar berfungsi.
Pilih model default. Kimi K3 adalah model flagship terbaru Kimi; jika tujuan utama Anda adalah coding, kimi-k2.7-code adalah pilihan yang lebih baik.
Jika Anda sudah mengetahui nilai yang ingin diatur, Anda dapat menggunakan hermes config set. Contohnya:
Jika Anda tidak memiliki kunci API, Kimi bisa menjadi pilihan yang baik.
Langkah 1: Aktifkan Kimi API Anda
Sebelum menggunakan Kimi API dengan Hermes Agent, aktifkan Kimi API Key Anda di Kimi Platform. Kami merekomendasikan $20+ untuk membuka akses Tier 2, yang mengurangi latensi dan mendukung performa lebih stabil untuk tugas kompleks dengan beberapa langkah
Langkah 2: Buat Kimi API Key Anda
Buka bagian API Keys di Kimi 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
Tempelkan Kimi API key Anda dan hubungkan Hermes Agent.
Langkah 3: Mulai Hermes Agent
Setelah model dikonfigurasi, jalankan CLI klasik:
Atau coba UI terminal yang lebih baru:
Anda akan melihat layar sambutan atau prompt yang menampilkan penyedia/model pilihan Anda. Uji dengan permintaan sederhana:
Hasil yang benar akan terlihat seperti ini:
Jika Hermes Agent terbuka tetapi menampilkan kesalahan model atau autentikasi, jalankan:
Lalu pilih kembali penyedia Anda dan verifikasi kunci API atau login OAuth.
Langkah 4: Jadikan Hermes Agent sebagai Bot
Seperti OpenClaw, Hermes Agent juga dapat berfungsi sebagai bot dan terhubung ke aplikasi chat Anda:
Setelah penyiapan, periksa status gateway:
Gunakan gateway hanya setelah penyedia model Anda berfungsi di terminal. Jika CLI tidak dapat menyelesaikan chat dasar, bot biasanya akan gagal karena alasan yang sama.
Masalah Umum saat Menginstal Hermes Agent
hermes: command not found
Penyebab: terminal Anda belum memuat ulang perubahan PATH.
Perbaikan:
Atau:
Lalu coba:
git: command not found
Penyebab: Git belum terinstal.
Perbaikan di Ubuntu, Debian, atau WSL2:
Perbaikan di macOS dengan Homebrew:
Kunci API Belum Diatur
Penyebab: Hermes Agent sudah terinstal, tetapi belum ada kunci penyedia atau login yang dikonfigurasi.
Perbaikan:
Atau atur kunci secara manual:
hermes doctor Melaporkan Konfigurasi Hilang atau Kedaluwarsa
Penyebab: file konfigurasi Anda mungkin tidak lengkap setelah pembaruan.
Perbaikan:
Endpoint Kustom Terhubung tetapi Memberikan Respons Buruk
Penyebab: URL dasar, nama model, atau panjang konteks tidak tepat.
Perbaikan: uji endpoint terlebih dahulu di klien terpisah, pastikan endpoint tersebut kompatibel dengan OpenAI, dan pastikan model mendukung konteks minimal 64K untuk alur kerja Hermes Agent normal.
Referensi Perintah Singkat
Kesimpulan
Cara termudah untuk menginstal Hermes Agent adalah menggunakan installer resmi satu baris, memuat ulang shell, menjalankan hermes model, lalu memverifikasi penyiapan dengan satu chat nyata serta hermes doctor. Buat penyiapan awal tetap sederhana: satu mesin, satu penyedia, satu percakapan yang berfungsi. Setelah asisten dasar Hermes Agent stabil, Anda dapat mengembangkannya dengan aman menggunakan isolasi Docker, bot gateway, skill, otomatisasi terjadwal, dan penyedia model kustom.
FAQ
~/.hermes/, dan dapat diperluas dengan keterampilan, memori, tugas terjadwal, serta gateway pesan.iex (irm https://hermes-agent.nousresearch.com/install.ps1) di PowerShell, atau menggunakan paket desktop MSIX. WSL2 tetap menjadi alternatif opsional.hermes model, pilih satu penyedia, seperti Kimi, mulai hermes, uji satu chat biasa, jalankan hermes doctor, lalu pastikan hermes --continue melanjutkan sesi Anda. Setelah itu, tambahkan isolasi Docker, skill, server MCP, suara, cron, atau gateway pesan sesuai kebutuhan.