Lewati ke konten utama

Cara Install Hermes Agent di Ubuntu — Panduan Lengkap

14 October 2026 • 4 menit baca • cara install Hermes Agent, Hermes Agent Ubuntu, instalasi Hermes Agent Linux, konfigurasi Hermes Agent, AI agent open-source

Cara Install Hermes Agent di Ubuntu: Panduan Lengkap untuk Pemula

Hermes Agent adalah AI agent open-source dari Nous Research yang dapat digunakan melalui terminal dan dikembangkan untuk menjalankan berbagai tugas dengan bantuan model AI dan tools yang tersedia. Dalam panduan ini, Anda akan mempelajari cara install Hermes Agent di Ubuntu, melakukan konfigurasi awal, menjalankan percakapan pertama, dan mengatasi kendala instalasi yang umum terjadi.

Panduan ini ditujukan untuk developer, IT administrator, AI enthusiast, dan pengguna yang ingin mulai mencoba AI agent di lingkungan Linux.

Apa Saja yang Perlu Disiapkan?

Sebelum memulai instalasi, pastikan Anda memiliki:

  1. Komputer atau server dengan Ubuntu Linux.
  2. Akses ke terminal.
  3. Koneksi internet yang stabil.
  4. Akun atau kredensial dari provider model AI yang didukung, atau opsi konfigurasi provider yang sesuai.
  5. Hak akses pengguna untuk memasang dependensi yang diperlukan.

Hermes Agent juga mendukung metode instalasi pada sistem lain, termasuk macOS, Windows, dan WSL2. Namun, panduan ini berfokus pada instalasi melalui terminal di Linux.

Langkah 1: Buka Terminal Ubuntu

Jika menggunakan Ubuntu Desktop, buka aplikasi Terminal. Jika menggunakan VPS, hubungkan melalui SSH menggunakan akun server Anda.

Periksa versi sistem operasi dengan perintah:

lsb_release -a

Pastikan koneksi internet tersedia sebelum melanjutkan.

Langkah 2: Install Hermes Agent

Menurut dokumentasi resmi Hermes Agent, instalasi CLI pada Linux dapat dimulai menggunakan perintah berikut:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Perintah tersebut mengunduh dan menjalankan skrip instalasi resmi. Installer menangani sejumlah kebutuhan instalasi, termasuk lingkungan runtime dan dependensi yang diperlukan.

Catatan keamanan: perintah di atas menjalankan skrip yang diunduh langsung dari internet. Untuk lingkungan produksi atau server perusahaan, tinjau skrip terlebih dahulu dan ikuti kebijakan keamanan organisasi sebelum menjalankannya.

Dokumentasi resmi: https://hermes-agent.nousresearch.com/docs/getting-started/installation/

Langkah 3: Muat Ulang Konfigurasi Shell

Setelah proses instalasi selesai, muat ulang konfigurasi shell agar perintah Hermes dapat dikenali:

source ~/.bashrc

Jika menggunakan Zsh, gunakan:

source ~/.zshrc

Perintah yang digunakan harus sesuai dengan shell aktif Anda.

Langkah 4: Lakukan Konfigurasi Awal

Jalankan wizard konfigurasi:

hermes setup

Ikuti instruksi yang muncul untuk memilih provider model AI dan pengaturan lain yang diperlukan.

Jika ingin menggunakan opsi Nous Portal, dokumentasi resmi juga menyediakan:

hermes setup --portal

Pilihan provider, model, serta akses ke tools tertentu dapat memengaruhi biaya penggunaan. Periksa ketentuan dan harga provider sebelum mengaktifkan layanan berbayar.

Langkah 5: Jalankan Hermes Agent

Setelah konfigurasi selesai, jalankan:

hermes

Cobalah memberikan instruksi sederhana dan pastikan agent dapat merespons dengan benar. Jika belum berhasil, pastikan konfigurasi provider, kredensial, koneksi jaringan, dan nama model sudah sesuai.

Untuk mengubah provider atau model di kemudian hari, Anda dapat menjalankan:

hermes model

Langkah 6: Periksa Instalasi Jika Terjadi Kendala

Apabila Hermes Agent tidak berjalan sebagaimana mestinya, gunakan perintah diagnostik:

hermes doctor

Beberapa masalah umum yang dapat terjadi antara lain:

1. Perintah hermes tidak ditemukan

Muat ulang konfigurasi shell, kemudian periksa apakah lokasi executable Hermes sudah termasuk dalam PATH.

2. API key belum dikonfigurasi

Jalankan hermes model atau wizard setup untuk memilih dan mengonfigurasi provider yang didukung.

3. Instalasi gagal karena dependensi

Periksa pesan error dan log instalasi. Jangan langsung menghapus direktori data Hermes karena direktori tersebut dapat berisi konfigurasi dan data pengguna.

4. Agent terpasang tetapi tidak dapat merespons

Periksa koneksi jaringan, kredensial, konfigurasi model, dan akses provider yang digunakan.

Apakah Hermes Agent Bisa Dipasang di VPS?

Ya. Hermes Agent dapat dijalankan pada lingkungan server yang sesuai, termasuk VPS Linux. Namun, kebutuhan resource, konfigurasi jaringan, dan pengaturan keamanan perlu disesuaikan dengan penggunaan Anda.

Jika akan digunakan sebagai layanan yang aktif terus-menerus, pertimbangkan pengelolaan proses, pembatasan akses, penyimpanan kredensial, pembaruan sistem, backup, serta monitoring.

Jangan mengekspos akses terminal atau gateway ke internet tanpa memahami autentikasi, izin akses, dan risiko keamanan yang terkait.

Kesimpulan

Instalasi Hermes Agent di Ubuntu dapat dimulai melalui installer resmi, dilanjutkan dengan konfigurasi provider model AI, dan pengujian percakapan pertama. Untuk memastikan hasil yang konsisten, selalu gunakan dokumentasi resmi sebagai acuan apabila perintah, dependensi, atau metode instalasi berubah.

Jika Anda baru memulai, pastikan fungsi dasar agent berjalan terlebih dahulu sebelum menambahkan integrasi, automasi, atau layanan tambahan.

Artikel terkait yang dapat Anda baca berikutnya:

  1. Cara Menjalankan Hermes Agent di VPS Linux
  2. Cara Konfigurasi Model AI pada Hermes Agent
  3. Cara Menghubungkan Hermes Agent dengan Telegram
  4. Tips Keamanan untuk AI Agent pada Server Produksi

Artikel ini disusun untuk tujuan edukasi teknis. Verifikasi kembali instruksi terhadap dokumentasi resmi Hermes Agent sebelum menerapkannya pada lingkungan produksi.

Butuh solusi digital untuk bisnis Anda?

Diskusikan Proyek →