Learning / AI Tools & Agent
Hermes Agent: Instalasi & Penggunaan Dasar

Sumber gambar: banner resmi dokumentasi Hermes Agent, https://hermes-agent.nousresearch.com/docs/img/hermes-agent-banner.png — hak merek milik Nous Research; dipakai sebagai ilustrasi edukasi dengan atribusi.
Apa itu Hermes Agent?
Hermes Agent adalah agent open-source buatan Nous Research yang kamu jalankan sendiri (laptop atau server). Ia punya tool (terminal, file, browser, web), memori, skill, jadwal (cron), dan gateway untuk diajak chat dari Telegram, Discord, Slack, dll. Kamu bebas memilih provider model: OpenRouter, Anthropic, OpenAI, Nous Portal, sampai model lokal (Ollama, LM Studio).
Prasyarat
- Mac: paket desktop resmi hanya untuk Apple Silicon (Mac Intel tidak didukung untuk installer desktop). Untuk CLI butuh Git, curl, tar.
- Windows: ada paket desktop (
.appinstaller) dan installer PowerShell native. Sebagian panduan provider lokal masih menyebut WSL2. - Satu akun provider model (misalnya OpenRouter + saldo, lihat modul Langganan vs API).
Instalasi (pilih salah satu)
Opsi A — Hermes Desktop: unduh paket untuk platformmu dari situs Hermes (Mac: buka DMG lalu salin Hermes.app ke Applications; Windows: buka file .appinstaller).
Opsi B — CLI saja:
Mac / Linux / WSL2:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows (PowerShell):
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Tips keamanan: perintah
curl … | bashmenjalankan skrip dari internet. Pastikan alamatnya persis domain resmi di atas.
Setelah selesai, muat ulang shell lalu jalankan:
source ~/.zshrc # Mac (zsh). Linux bash: source ~/.bashrc
hermes # mulai chat
Perintah penting
| Perintah | Fungsi |
|---|---|
hermes | Mulai chat di terminal |
hermes setup | Wizard lengkap |
hermes model | Pilih provider & model (di luar sesi chat) |
/model | Ganti model di dalam sesi (hanya provider yang sudah disetel) |
hermes tools | Atur tool yang aktif |
hermes gateway setup | Setel Telegram/Discord/dll |
hermes doctor | Diagnosa masalah |
hermes config set … / hermes config get … | Ubah/lihat satu setelan |
Pakai OpenRouter sebagai provider
- Buat API key di OpenRouter (lihat modul Langganan vs API).
- Jalankan
hermes model→ pilih OpenRouter → tempel key. Atau taruh di~/.hermes/.env:
OPENROUTER_API_KEY=ISI_KEY_KAMU_DI_SINI
- Model untuk OpenRouter memakai format
vendor/nama-model(contoh dari docs:anthropic/claude-sonnet-4). Cek daftar model terbaru di https://openrouter.ai/models — jangan menebak nama model. - Opsional hemat biaya, di
~/.hermes/config.yaml:
provider_routing:
sort: "price" # price | throughput | latency
data_collection: "deny"
Keamanan bawaan yang perlu kamu tahu
- Persetujuan perintah berbahaya (
approvals.mode: smartdefault). Jangan nyalakan/yoloatau--yolokecuali di lingkungan sekali pakai. - Hardline blocklist: perintah sangat berbahaya (misal
rm -rf /) selalu ditolak. - Simpan key hanya di
~/.hermes/.env, laluchmod 600 ~/.hermes/.env. Jangan pernah commit file.env.
Contoh penggunaan
- "Ringkas semua file PDF di folder ini jadi satu catatan."
- "Setiap jam 7 pagi kirim ringkasan berita AI ke Telegram saya" (pakai cron + home channel).
- Mendelegasikan tugas koding ke OpenCode/Claude Code/Codex lewat skill bawaan.
Troubleshooting
| Masalah | Solusi |
|---|---|
hermes: command not found | Muat ulang shell (source ~/.zshrc) atau cek PATH |
API key not set | hermes model, atau hermes config set OPENROUTER_API_KEY … |
| Config hilang setelah update | hermes config check lalu hermes config migrate |
Ingin ganti ke provider baru tapi /model tidak menampilkannya | Keluar sesi, jalankan hermes model |
Latihan
- Install Hermes, jalankan
hermes doctor, catat hasilnya. - Setel OpenRouter, tanyakan "Apa saja tool yang kamu punya?".
- Ubah
provider_routing.sortkeprice, bandingkan biaya di halaman Activity OpenRouter.
Video tutorial
Video milik kreatornya masing-masing, disematkan dari YouTube (tidak diunggah ulang). Jika isi video berbeda dengan materi, ikuti materi & dokumen resmi.
Channel: Biks AI · Bahasa: Indonesia · Review komunitas Indonesia
⚠️ Video review dengan opini kreator; perintah install ikuti materi/dokumentasi resmi.
Tonton di YouTube ↗Channel: Dedi Nugroho · Bahasa: Indonesia · Tutorial komunitas Indonesia (pengenalan dashboard)Tonton di YouTube ↗
Channel: Tina Huang · Bahasa: Inggris · Tutorial komunitas
⚠️ Video komunitas; perintah instalasi & menu bisa berubah. Cocokkan dengan dokumentasi resmi Hermes.
Tonton di YouTube ↗