Cara Install Hermes Agent di Ubuntu 24.04

Hermes Agent adalah agent AI terminal-native dari Nous Research yang berjalan langsung di shell, menyimpan memory antar sesi, dan menjalankan tool seperti terminal, file, serta web search. Memasangnya di Ubuntu 24.04 dapat diselesaikan dengan satu perintah curl resmi karena installer memasang seluruh dependency secara otomatis. Setelah instalasi selesai, Anda perlu memilih provider model dan memverifikasi bahwa agent benar-benar bisa menjalankan perintah.

Requirements

• Ubuntu 24.04 (Noble Numbat).
• Hak akses sudo.
• Ruang disk minimal 2 GB untuk checkout, virtual environment, dan dependency.
• Kredensial salah satu provider model, misalnya API key OpenRouter atau akun Nous Portal.

Hermes Agent adalah aplikasi command-line biasa. Anda tidak perlu Docker, GPU, atau server terpisah untuk memasang agent di mesin ini.

Environment

• Sistem operasi: Ubuntu 24.04 (Noble Numbat)
• Arsitektur: x86_64
• Akses: user dengan hak sudo
• Shell: Bash

Paket Prasyarat untuk Hermes Agent

Installer resmi Hermes Agent mengunduh Node.js dalam bentuk archive .tar.xz, sehingga Ubuntu membutuhkan curl, git, dan xz-utils. Pasang ketiganya sebelum menjalankan installer.

sudo apt update
sudo apt install -y curl git xz-utils

Jika Anda ingin menjalankan aplikasi desktop Hermes, pasang juga compiler native:

sudo apt install -y build-essential

Paket build-essential hanya diperlukan untuk aplikasi desktop Electron. Untuk pemakaian command-line, tiga paket pertama sudah cukup.

Install Hermes Agent di Ubuntu 24.04

Jalankan installer resmi sebagai user biasa. Installer memasang Python 3.11 melalui uv, Node.js v26, ripgrep, ffmpeg, dan seluruh dependency lain tanpa sudo.

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

Output:

✓ Installing Python dependencies
✓ Preparing Node dependencies
✓ Building the TUI
✓ Building the web UI
✓ Model catalog cache refreshed from checkout
→ Syncing bundled skills...
✓ Install complete! [main @ 996c25291]
✓ added ~/.local/bin to PATH in /root/.bashrc
✓ Hermes Agent install complete. Run: hermes

Pemanggilan installer dengan bash di akhir pipa sengaja dipakai: script harus dibaca seluruhnya sebelum dijalankan, dan tidak memerlukan hak root. Installer menempatkan kode di ~/.hermes/hermes-agent/, symlink executable di ~/.local/bin/hermes, dan data di ~/.hermes/.

Installer memakan waktu beberapa menit karena mengunduh Python, Node.js, dan package Python. Setelah selesai, muat ulang shell agar direktori ~/.local/bin masuk ke PATH.

source ~/.bashrc

Verifikasi Instalasi Hermes Agent di Ubuntu 24.04

Cek bahwa executable hermes terdeteksi dan tata letak instalasinya sesuai.

command -v hermes

Output yang diharapkan menunjuk ke symlink per-user:

/home/<user>/.local/bin/hermes

Jalankan pemeriksaan versi untuk memastikan binary berjalan.

hermes --version

Output:

Hermes Agent v0.21.5+2044.g996c252 (2026.9.24) · upstream 996c2529
Install directory: /root/.hermes/hermes-agent
Install method: git
Python: 3.14.7
OpenAI SDK: 2.24.0

Installer juga menyediakan hermes doctor yang mendiagnosis konfigurasi, dependency, dan service secara langsung.

hermes doctor

Output:

◆ Required Packages
  ✓ OpenAI SDK
  ✓ Rich (terminal UI)
◆ Configuration Files
  ✓ ~/.hermes/.env file exists
  ✓ ~/.hermes/config.yaml exists
  ✓ Config version up to date (v46)
◆ Directory Structure
  ✓ ~/.hermes directory exists
  ✓ ~/.hermes/skills/ exists

hermes doctor melaporkan status environment, install method yang terdeteksi (git installer), dan masalah config bila ada. Pada instalasi baru, provider dan model belum diisi sehingga Anda akan diarahkan ke langkah konfigurasi berikutnya.

Konfigurasi Provider dan Model

Pilih provider dan model melalui wizard interaktif. Perintah ini dijalankan dari terminal, bukan dari dalam sesi chat.

hermes model

Wizard menampilkan daftar provider yang didukung, termasuk OpenRouter, Nous Portal, Anthropic, OpenAI Codex, DeepSeek, dan custom endpoint. Setelah memilih provider, masukkan API key saat diminta. Nilai rahasia otomatis disimpan ke ~/.hermes/.env, sedangkan setelan non-rahasia masuk ke ~/.hermes/config.yaml.

Alternatif satu perintah untuk pengguna Nous Portal adalah:

hermes setup --portal

Perintah tersebut membuka OAuth, menetapkan Nous sebagai provider, dan mengaktifkan Tool Gateway sekaligus.

Jika Anda memakai endpoint lokal (misalnya Ollama), arahkan Hermes ke endpoint tersebut dengan menyunting ~/.hermes/config.yaml. Gunakan text editor pilihan Anda:

nano ~/.hermes/config.yaml

vim ~/.hermes/config.yaml

Tambahkan blok model: berikut:

model:
  default: "gemma3:27b"
  provider: "custom"
  base_url: "http://localhost:11434/v1"

Model wajib punya context window minimal 64.000 token. Di bawah angka itu, Hermes menolak model di startup. Setelah provider tersimpan, konfirmasi nilai yang benar-benar dipakai:

hermes config get model

Pengujian Fungsional

Pengujian fungsional memastikan agent benar-benar memanggil model dan menjalankan tool, bukan hanya menampilkan banner. Mulai dengan satu percakapan singkat.

hermes chat --oneshot -q "Balas dengan kata: siap"

Output yang diharapkan adalah balasan teks dari model, misalnya:

siap

Lanjutkan dengan pengujian yang memaksa agent memakai tool terminal. Perintah ini meminta agent menghitung jumlah file di direktori saat ini sehingga tool terminal benar-benar dieksekusi.

hermes chat --oneshot -q "Jalankan perintah 'ls -1 | wc -l' lalu laporkan hasil angkanya saja."

Agent akan menjalankan perintah shell dan mengembalikan angka jumlah entri direktori. Balasan yang berisi angka hasil hitungan menandakan loop tool-calling berfungsi.

Verifikasi terakhir adalah sesi yang dapat dilanjutkan. Jalankan percakapan interaktif singkat, keluar, lalu lanjutkan sesi terakhir.

hermes --continue

Jika sesi sebelumnya berhasil disimpan, Hermes membuka kembali percakapan tersebut dengan konteks yang sama. Kegagalan pada tahap ini biasanya berarti sesi tidak tersimpan karena profil berbeda atau provider belum terkonfigurasi.

Troubleshooting

hermes: command not found

Shell belum memuat ulang ~/.bashrc, sehingga direktori ~/.local/bin belum ada di PATH. Jalankan source ~/.bashrc, lalu cek dengan command -v hermes. Jika masih gagal, pastikan baris export PATH="$HOME/.local/bin:$PATH" ada di ~/.bashrc.

Balasan kosong atau error saat chat

Penyebab paling umum adalah provider atau model belum dipilih dengan benar. Jalankan hermes model lagi, lalu konfirmasi provider, nama model, dan status autentikasinya. Cek juga nilai yang tersimpan dengan hermes config get model.

hermes doctor melaporkan masalah konfigurasi

Setelan yang hilang setelah update dapat ditambahkan tanpa mengulang wizard penuh. Jalankan hermes config check untuk melihat opsi yang belum ada, lalu hermes config migrate untuk menambahkannya secara interaktif.

Model lokal menolak dijalankan

Hermes mensyaratkan context window minimal 64.000 token. Untuk Ollama, buat varian model dengan konteks lebih besar, misalnya melalui Modelfile dengan PARAMETER num_ctx 64000, lalu arahkan model.default ke nama model varian tersebut.

Verifikasi

Ringkasan pemeriksaan yang harus lolos sebelum instalasi dianggap selesai:

• command -v hermes menunjuk ke ~/.local/bin/hermes.
• hermes --version mengembalikan versi tanpa error.
• hermes doctor selesai tanpa masalah dependency yang belum terselesaikan.
• hermes chat --oneshot -q "..." membalas melalui model yang dipilih.
• Perintah yang memaksa pemakaian tool terminal mengembalikan hasil eksekusi, bukan balasan kosong.
• hermes --continue membuka kembali sesi terakhir.

Jika seluruh pemeriksaan di atas lolos, Hermes Agent siap dipakai di Ubuntu 24.04. Gunakan hermes tools untuk mengatur tool per platform dan hermes skills untuk memasang workflow siap pakai. Saat ingin menghubungkan agent ke Telegram, Discord, atau Slack, jalankan hermes gateway setup.