Instalasi & Setup Hermes Agent

Apa Itu Hermes Agent?

Hermes Agent adalah AI agent open-source dari Nous Research yang bisa menjalankan pekerjaan menggunakan AI, tools, terminal, browser, memory, skills, dan berbagai integrasi lainnya.

Berbeda dengan chatbot biasa, Hermes tidak hanya menjawab pertanyaan. Ia dapat melakukan tindakan langsung di komputer atau server kita.

Sederhananya:

Kamu
 ↓
Hermes Agent
 ↓
AI Model
 ↓
Tools / Terminal / Browser / Skills / Memory
 ↓
Mengerjakan Tugas

Hermes dapat digunakan untuk:

• +

  Coding dan debugging

• +

  Research

• +

  Menjalankan command terminal

• +

  Membaca dan mengedit file

• +

  Browser automation

• +

  Membuat automation

• +

  Menggunakan Skills dan MCP

• +

  Menjalankan beberapa agent

• +

  Terhubung ke WhatsApp, Telegram, Discord, Slack, dan platform lainnya

Hermes juga memiliki sistem memory dan learning sehingga agent dapat menyimpan pengalaman, membuat skill baru, serta menggunakan kembali pengetahuan dari pekerjaan sebelumnya.

Sebelum Instalasi

Untuk instalasi normal, kita tidak perlu menginstall Python, Node.js, ripgrep, atau ffmpeg secara manual.

Installer Hermes akan menyiapkan dependency tersebut secara otomatis. Saat ini installer menangani Python 3.11, Node.js 22, uv, ripgrep, ffmpeg, virtual environment, dan Hermes Agent itu sendiri.

Windows

Cukup siapkan:

Windows 10 / 11
PowerShell
Internet

Hermes sekarang dapat berjalan langsung secara native di Windows tanpa WSL, Cygwin, atau Docker.

Linux

Pastikan tersedia:

Git
curl
xz-utils

Untuk Ubuntu/Debian:

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

Dependency Hermes lainnya akan ditangani installer secara otomatis.

Instalasi Hermes di Windows

Buka PowerShell, kemudian jalankan:

$ irm https://hermes-agent.nousresearch.com/install.ps1 | iex

Installer akan menyiapkan Hermes beserta dependency yang dibutuhkan secara otomatis. Dokumentasi resmi juga menyediakan installer native PowerShell untuk Windows.

Setelah selesai, tutup dan buka kembali PowerShell jika diperlukan.

Kemudian cek:

$ hermes --version

Instalasi Hermes di Linux

Buka Terminal, kemudian jalankan:

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

Setelah instalasi selesai, reload shell:

$ source ~/.bashrc

atau jika menggunakan Zsh:

$ source ~/.zshrc

Kemudian cek:

$ hermes --version

Installer resmi merupakan metode tercepat untuk instalasi Hermes pada Linux, macOS, dan WSL2.

Setup Pertama

Setelah Hermes terinstall, cara tercepat melakukan setup adalah:

$ hermes setup --portal

Command tersebut menjalankan login Nous Portal, memilih provider Nous, serta mengaktifkan Tool Gateway secara otomatis. Ini merupakan fast path yang direkomendasikan dokumentasi Hermes saat ini.

Setelah selesai:

$ hermes

Hermes sudah siap digunakan.

Jika Ingin Menggunakan Provider Sendiri

Tidak wajib menggunakan Nous Portal.

Untuk memilih provider atau model lain:

$ hermes model

Dari sini kita dapat mengatur model/provider yang ingin digunakan. Hermes mendukung berbagai provider serta custom OpenAI-compatible endpoint.

Contohnya bisa berupa:

Nous
OpenAI / Codex
Anthropic
OpenRouter
Google
DeepSeek
Custom Endpoint
dan lainnya

Setelah model terhubung:

$ hermes

dan mulai gunakan agent.

Menjalankan Hermes

Cara paling sederhana:

$ hermes

Untuk langsung memberikan satu perintah:

$ hermes chat -q "Jelaskan isi project ini"

Hermes juga memiliki modern Terminal UI:

$ hermes --tui

TUI menyediakan interface terminal yang lebih modern dengan streaming output, autocomplete, dan interaction yang lebih nyaman.

Dashboard

Jika lebih suka interface browser:

$ hermes dashboard

Hermes menyediakan web dashboard untuk mengatur konfigurasi, API key, dan session tanpa harus selalu mengedit file konfigurasi secara manual.

Mengecek Status Hermes

Gunakan:

$ hermes status

Untuk memastikan provider, authentication, dan konfigurasi Hermes dalam kondisi normal.

Update Hermes

Untuk update ke versi terbaru:

$ hermes update

Hermes akan mengambil versi terbaru, memperbarui dependency, melakukan pengecekan konfigurasi baru, dan me-restart gateway jika diperlukan.

Untuk hanya mengecek apakah update tersedia:

$ hermes update --check

Troubleshooting

hermes Command Tidak Ditemukan

Jika muncul:

hermes: command not found

atau:

'hermes' is not recognized

tutup terminal kemudian buka kembali.

Pada Linux jalankan:

$ source ~/.bashrc

atau:

$ source ~/.zshrc

Kemudian coba:

$ hermes --version

Instalasi Linux Gagal

Pastikan dependency awal tersedia:

$ git --version
curl --version
xz --version

Ubuntu/Debian:

$ sudo apt install git curl xz-utils -y

Kemudian jalankan installer kembali:

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

Hermes membutuhkan Git pada platform non-Windows serta curl dan xz-utils pada Linux untuk proses installer.

Hermes Error atau Tidak Berjalan Normal

Jalankan:

$ hermes doctor

Ini adalah command diagnosis utama Hermes untuk mengecek dependency, konfigurasi, dan kondisi service.

Kemudian cek:

$ hermes status

Model / Provider Tidak Bisa Digunakan

Jalankan kembali:

$ hermes model

Kemudian pilih atau login ulang ke provider.

Untuk mengecek authentication:

$ hermes auth status

Hermes menyediakan hermes auth untuk mengelola OAuth dan credential provider.

Config Bermasalah Setelah Update

Jalankan:

$ hermes config check

Jika ada konfigurasi baru yang belum tersedia:

$ hermes config migrate

Hermes juga melakukan pengecekan konfigurasi baru secara otomatis ketika menjalankan hermes update.

hermes update Error di Windows

Windows dapat menolak update jika Hermes Desktop, Hermes CLI, atau Gateway masih berjalan karena executable sedang digunakan.

Tutup Hermes Desktop dan session Hermes lainnya, kemudian:

$ hermes gateway stop

Setelah itu:

$ hermes update

Ini merupakan mekanisme proteksi updater Hermes pada Windows agar virtual environment tidak rusak saat file sedang digunakan.

Command Penting

Untuk penggunaan dasar, cukup ingat:

$ # Jalankan Hermes
hermes

# Pilih model/provider
hermes model

# Setup cepat
hermes setup --portal

# Cek status
hermes status

# Buka dashboard
hermes dashboard

# Cari masalah
hermes doctor

# Atur tools
hermes tools

# Update Hermes
hermes update

Ringkasan

Instalasi Hermes sekarang sangat sederhana.

Windows

$ irm https://hermes-agent.nousresearch.com/install.ps1 | iex

Linux

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

Kemudian setup tercepat:

$ hermes setup --portal

dan jalankan:

$ hermes

Flow dasarnya:

Install Hermes
      ↓
Setup Provider
      ↓
Pilih Model
      ↓
Jalankan Hermes
      ↓
Agent Siap Digunakan

Kalau terjadi masalah, dua command pertama yang perlu dicoba adalah:

$ hermes doctor
hermes status

Setelah instalasi dasar berhasil, baru lanjut ke fitur yang lebih advanced seperti Skills, MCP, browser & terminal tools, WhatsApp/Telegram Gateway, memory, cron automation, multi-agent, atau custom AI provider.