DEV Community

Cover image for Cara Menggunakan Hermes Agent
Walse
Walse

Posted on • Originally published at apidog.com

Cara Menggunakan Hermes Agent

TL;DR: Hermes Agent adalah asisten AI open source yang dapat mengingat dan belajar dari interaksi Anda, semakin cerdas seiring waktu. Instalasi hanya butuh satu perintah, konfigurasi penyedia LLM, dan Anda sudah bisa mengobrol via CLI, Telegram, Discord, atau langsung dari IDE. Artikel ini membahas langkah instalasi, konfigurasi awal, penggunaan, fitur advance, serta tips optimalisasi Hermes.

Coba Apidog hari ini

Apa itu Hermes Agent?

Hermes Agent adalah AI asisten pribadi dari NousResearch yang berjalan 24/7, mengingat semua interaksinya, dan terus berkembang. Berbeda dari ChatGPT atau Claude, Hermes membangun model persisten dari project, preferensi, dan cara kerja Anda.

Hermes Agent

Fitur Utama:

  • Mengingat: Simpan percakapan, keputusan, dan kode Anda.
  • Belajar: Buat skill reusable dari tugas berulang.
  • Multi-platform: Obrolan via CLI, Telegram, Discord, Slack, WhatsApp, atau IDE.
  • Self-hosted: Jalan di laptop, VPS $5, atau cloud.
  • Agnostik model: Pilih dari 200+ model via OpenRouter, atau direct provider.
  • Ekstensibel: Sistem plugin untuk tool & command custom.

Untuk siapa Hermes?

  • Developer yang ingin AI pair programmer yang paham codebase mereka.
  • Tim yang perlu AI asisten multi-user.
  • Power user yang ingin agent otomatis 24/7 via cron.
  • Peneliti yang ingin melatih custom model dengan data trajectory.

Instalasi: Langkah demi Langkah

Prasyarat

  • OS: macOS, Linux, atau Windows (WSL disarankan)
  • Python: 3.10+
  • Git: Untuk clone repo
  • API Key: OpenRouter, Anthropic, OpenAI, dll.

Instalasi Cepat (Rekomendasi) 

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

Skrip di atas:

  1. Meng-clone repo Hermes
  2. Instal uv (package manager Python cepat)
  3. Membuat virtual environment
  4. Instal semua dependensi
  5. Menambahkan Hermes ke PATH

Reload shell Anda:

source ~/.bashrc # Untuk bash
source ~/.zshrc  # Untuk zsh
Enter fullscreen mode Exit fullscreen mode

Verifikasi instalasi:

hermes --version
Enter fullscreen mode Exit fullscreen mode

Output: Hermes Agent v0.5.0 (atau terbaru).

Instalasi Manual (Untuk Developer) 

# Clone repo
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Instal uv jika belum ada
curl -LsSf https://astral.sh/uv/install.sh | sh

# Buat & aktifkan virtual env
uv venv venv --python 3.11
source venv/bin/activate # Linux/macOS
# atau
.\venv\Scripts\activate  # Windows

# Instal Hermes dengan semua fitur
uv pip install -e ".[all,dev]"

# Jalankan test
python -m pytest tests/ -q
Enter fullscreen mode Exit fullscreen mode

Instalasi dengan Dukungan RL Training 

# Inisialisasi submodul Atropos
git submodule update --init tinker-atropos

# Instal dependensi training
uv pip install -e "./tinker-atropos"
Enter fullscreen mode Exit fullscreen mode

Pengaturan dan Konfigurasi Awal

Jalankan Wizard Pengaturan

Untuk pengguna baru:

hermes setup
Enter fullscreen mode Exit fullscreen mode

Wizard akan membimbing:

  1. Pilih penyedia LLM (OpenRouter, Anthropic, OpenAI, dll)
  2. Atur API key (disimpan di ~/.hermes/.env)
  3. Konfigurasi memori (on/off persistent memory)
  4. Terminal backend (local, Docker, SSH, cloud)
  5. Pengaturan gateway (opsional: Telegram, Discord, Slack)

Konfigurasi Manual

Edit file konfigurasi:

hermes config edit
Enter fullscreen mode Exit fullscreen mode

Atau via CLI:

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend local
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...
Enter fullscreen mode Exit fullscreen mode

Lokasi File Konfigurasi 

~/.hermes/
├── config.yaml   # Config utama
├── .env          # API key (jaga kerahasiaan!)
├── memory/       # Persistent memory
├── skills/       # Installed skills
└── plugins/      # Custom plugins
Enter fullscreen mode Exit fullscreen mode

Verifikasi Pengaturan 

hermes doctor
Enter fullscreen mode Exit fullscreen mode

Cek:

  • Validasi konfigurasi
  • Koneksi API key
  • Status memory system
  • Status gateway (jika aktif)
  • Backend terminal

Memilih Penyedia LLM Anda

Hermes support >200 model dari banyak provider. Cara setup:

OpenRouter (Rekomendasi untuk Pemula)

Kelebihan: Satu API key untuk akses 200+ model. Ada tier gratis.

Setup:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...
Enter fullscreen mode Exit fullscreen mode

Model populer di OpenRouter:

Model Kasus Penggunaan Biaya
anthropic/claude-opus-4 Pengkodean kompleks, penalaran $$$
anthropic/claude-sonnet-4 Performa seimbang $$
openai/gpt-4o Tujuan umum $$
google/gemini-pro-1.5 Context window panjang $
meta/llama-3-70b Open source, cepat $

Anthropic Langsung

Kelebihan: Best-in-class untuk coding & reasoning.

Setup:

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4
Enter fullscreen mode Exit fullscreen mode

OpenAI Langsung

Kelebihan: Akses GPT-4o & GPT-4o1.

Setup:

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...
Enter fullscreen mode Exit fullscreen mode

Model Lokal (Ollama)

Kelebihan: 100% gratis, private, offline.

Setup:

# Instal Ollama: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b
Enter fullscreen mode Exit fullscreen mode

Contoh Konfigurasi Model

Routing cerdas (tugas kompleks = model mahal, lainnya = murah):

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini
Enter fullscreen mode Exit fullscreen mode

Kontrol biaya (limit budget):

model:
  budget:
    daily_limit: 5.00   # USD
    monthly_limit: 100.00
Enter fullscreen mode Exit fullscreen mode

Penggunaan Dasar: Mode CLI

Memulai Hermes 

hermes
Enter fullscreen mode Exit fullscreen mode

Langsung bisa ngobrol di CLI.

Perintah Dasar

Ngobrol natural:

> Hai, bisakah Anda membantu saya menulis fungsi Python untuk menguraikan JSON?
Enter fullscreen mode Exit fullscreen mode

Perintah slash:

> /help         # Semua perintah
> /skills       # Daftar skill
> /memory       # Status memory
> /config       # Config view/edit
> /clear        # Hapus sesi
> /history      # Riwayat chat
Enter fullscreen mode Exit fullscreen mode

Tugas file-based:

> Lihat file ./src/main.py dan refaktor koneksi database
Enter fullscreen mode Exit fullscreen mode

Jalankan perintah terminal:

> Jalankan: npm install && npm run build
Enter fullscreen mode Exit fullscreen mode

Hermes selalu minta konfirmasi sebelum mengeksekusi perintah.

Shell Persisten

Shell state tetap aktif:

> cd /my/project && source venv/bin/activate
> python src/main.py  # Masih dalam sesi shell yang sama
Enter fullscreen mode Exit fullscreen mode

Bekerja dengan File

Baca file:

> Tunjukkan isi config.yaml
Enter fullscreen mode Exit fullscreen mode

Edit:

> Di main.py, ubah port database dari 5432 jadi 5433
Enter fullscreen mode Exit fullscreen mode

Buat file baru:

> Buat file baru bernama utils.py dengan fungsi helper format tanggal
Enter fullscreen mode Exit fullscreen mode

Alur Kerja Multi-Langkah 

> Saya perlu menambahkan autentikasi user ke aplikasi Flask saya. Bisa tolong:
> 1. Setup model database
> 2. Endpoint login/logout
> 3. Token JWT
> 4. Tes alur autentikasi
Enter fullscreen mode Exit fullscreen mode

Hermes akan menjalankan step-by-step, minta konfirmasi tiap langkah.

Gateway Pesan: Telegram, Discord, Slack

Hermes bisa jadi bot di berbagai platform chat.

Pengaturan Telegram

  1. Buat bot:

    • Cari @botfather di Telegram
    • /newbot lalu ikuti instruksi
    • Salin token bot

  2. Konfigurasi Hermes:

   hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Enter fullscreen mode Exit fullscreen mode
  1. Mulai gateway: 
   hermes gateway setup telegram
   hermes gateway start
Enter fullscreen mode Exit fullscreen mode
  1. Mulai chat:
    • Temukan bot di Telegram
    • /start
    • Chat seperti di CLI

Pengaturan Discord

  1. Buat aplikasi Discord:

  2. Undang bot ke server:

    • "OAuth2" → "URL Generator"
    • Scope: "bot"
    • Buka URL hasil generate

  3. Konfigurasi Hermes:

   hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
   hermes gateway setup discord
   hermes gateway start
Enter fullscreen mode Exit fullscreen mode
  1. Gunakan di Discord:
    • Mention bot: @Hermes bantu saya menulis fungsi...
    • Atau lewat DM

Pengaturan Slack

  1. Buat app Slack:

  2. Install ke workspace & salin token

  3. Konfigurasi Hermes:

   hermes config set SLACK_BOT_TOKEN xoxb-...
   hermes gateway setup slack
   hermes gateway start
Enter fullscreen mode Exit fullscreen mode

Penggunaan Multi-Platform

Jalankan semua gateway sekaligus:

hermes gateway start --all
Enter fullscreen mode Exit fullscreen mode

Hermes sync status chat lintas platform.

Integrasi IDE: VS Code, JetBrains

Hermes bisa diintegrasikan ke editor via Agent Communication Protocol (ACP).

Integrasi VS Code

  1. Install ekstensi ACP:

    • Buka VS Code → Extensions (Ctrl+Shift+X)
    • Cari "Agent Communication Protocol"
    • Install

  2. Konfigurasi Hermes sebagai backend:

   hermes acp start
Enter fullscreen mode Exit fullscreen mode
  1. Gunakan di VS Code:
    • Buka sidebar ACP
    • Pilih Hermes sebagai agent
    • Chat & slash command langsung dari editor

Integrasi JetBrains (IntelliJ, PyCharm, dll.)

  1. Install plugin ACP:

    • Settings → Plugin → Cari "ACP"/"Agent Communication Protocol"
    • Install & restart

  2. Start server ACP Hermes:

   hermes acp start
Enter fullscreen mode Exit fullscreen mode
  1. Konfigurasi di JetBrains:
    • Settings → Tools → AI Agent
    • Tambahkan Hermes sebagai backend ACP
    • Test koneksi

Editor Zed

  1. Konfigurasi di Zed: 
   {
     "agent": {
       "provider": "acp",
       "endpoint": "hermes"
     }
   }
Enter fullscreen mode Exit fullscreen mode
  1. Jalankan Hermes: 
   hermes acp start
Enter fullscreen mode Exit fullscreen mode

Sistem Memori dan Pembelajaran

Hermes unggul di arsitektur memori. Manfaatkan fitur berikut:

Jenis Memori

  • Memori Episodik: Simpan riwayat percakapan/sesi. 
  > /memory search "migrasi database"
Enter fullscreen mode Exit fullscreen mode
  • Memori Semantik: Bangun knowledge graph project & preferensi. 
  > /memory projects
Enter fullscreen mode Exit fullscreen mode
  • Memori Prosedural (Skills): Reusable workflow. 
  > /skills list
Enter fullscreen mode Exit fullscreen mode

Pencarian Sesi

Cari pekerjaan terdahulu secara semantik:

> /memory search "Bagaimana kita menangani kedaluwarsa JWT minggu lalu?"
Enter fullscreen mode Exit fullscreen mode

Dorongan Memori

Hermes otomatis menyarankan context relevan:

[Hermes]: Anda sedang mengerjakan sistem autentikasi. Mau review masalah JWT kedaluwarsa minggu lalu?
Enter fullscreen mode Exit fullscreen mode

Kompresi Konteks

  • Kompresi Gateway: Saat konteks >85%
  • Kompresi Agen: Saat konteks >50% (bisa diubah)
  • Hasil: Chat tanpa batas konteks manual.

Ekspor & Backup

Ekspor memori:

hermes memory export ~/backup/hermes-memory.json
Enter fullscreen mode Exit fullscreen mode

Impor memori:

hermes memory import ~/backup/hermes-memory.json
Enter fullscreen mode Exit fullscreen mode

Keterampilan dan Plugin

Apa Itu Keterampilan?

Skill = workflow reusable yang bisa dieksekusi Hermes. Layaknya macro untuk tugas kompleks.

Skill bawaan:

  • code_review — Review bug & style code
  • debug_session — Debugging workflow
  • api_tester — Uji API REST/GraphQL
  • git_workflow — Git best practice ops
  • documentation — Auto-generate dokumentasi dari code

Jelajahi & Instal Skills

Lihat skill:

> /skills list
Enter fullscreen mode Exit fullscreen mode

Install skill:

> /skills install code_review
Enter fullscreen mode Exit fullscreen mode

Gunakan skill:

> /skills run code_review ./src/auth.py
Enter fullscreen mode Exit fullscreen mode

Keterampilan Kustom

Buat skill sendiri di ~/.hermes/skills/:

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "Melakukan sesuatu yang berguna"

    def execute(self, context):
        # Logika skill Anda
        return "Keterampilan berhasil dieksekusi"
Enter fullscreen mode Exit fullscreen mode

Sistem Plugin

Plugin = perluasan Hermes (tool, command, hook).

Contoh plugin:

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "Alat kustom untuk tugas-tugas tertentu"

    def run(self, **kwargs):
        # Logika alat
        return {"result": "sukses"}
Enter fullscreen mode Exit fullscreen mode

Tipe plugin:

  • Tool: Kemampuan baru agent
  • Command: Slash command baru
  • Hook: Lifecycle event handler

Fitur Lanjutan

Penjadwalan Cron

Jadwalkan task otomatis:

> Atur ringkasan harian notifikasi GitHub saya pada pukul 9 pagi
Enter fullscreen mode Exit fullscreen mode

Atau manual di config.yaml:

cron:
  - name: "Ringkasan Harian"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"
Enter fullscreen mode Exit fullscreen mode

Delegasi Subagen

Hermes bisa spawn sub-agent untuk tugas paralel:

> Tolong review semua PR di repo saya dan ringkas perubahannya
Enter fullscreen mode Exit fullscreen mode

Mode Suara

  • CLI: 
  hermes --voice
Enter fullscreen mode Exit fullscreen mode
  • Telegram/Discord: Kirim voice note, Hermes transkrip & jawab.
  • Discord voice channel: Hermes bisa join, bicara & dengar real-time.

Kontrol Browser

Integrasi dengan Browser Use CLI 2.0 untuk automasi web:

> Pergi ke github.com dan temukan 5 repositori Python terpopuler
Enter fullscreen mode Exit fullscreen mode

Atau konek ke Chrome via CDP:

hermes browser connect --cdp
Enter fullscreen mode Exit fullscreen mode

Integrasi MCP

Dukungan Model Context Protocol server:

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]
Enter fullscreen mode Exit fullscreen mode

Mode Worktree

Jalankan Hermes di worktree git terisolasi:

hermes -w
Enter fullscreen mode Exit fullscreen mode

Beberapa agent bisa kerja di repo yang sama tanpa konflik.

Jalankan Agen Lain di Dalam Hermes

Hermes bisa memanggil agent AI lain sebagai subagent:

> Gunakan claude-code untuk review pull request ini
Enter fullscreen mode Exit fullscreen mode

Pemecahan Masalah

Masalah Umum

"Kunci API tidak ditemukan"

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...
Enter fullscreen mode Exit fullscreen mode

"Model tidak tersedia"

hermes models list
hermes config set model anthropic/claude-opus-4
Enter fullscreen mode Exit fullscreen mode

"Gateway gagal dimulai"

hermes gateway status
hermes gateway stop
hermes gateway start
Enter fullscreen mode Exit fullscreen mode

"Kerusakan memori terdeteksi"

hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json
Enter fullscreen mode Exit fullscreen mode

Mendapatkan Bantuan

Bantuan CLI:

> /help
Enter fullscreen mode Exit fullscreen mode

Lihat log:

hermes logs tail --follow
Enter fullscreen mode Exit fullscreen mode

Jalankan diagnostik:

hermes doctor
Enter fullscreen mode Exit fullscreen mode

FAQ

Berapa biaya menjalankan Hermes?

Hermes gratis. Anda hanya bayar LLM usage.

  • Ringan: $5-15/bln (OpenRouter)
  • Sedang: $20-50/bln
  • Berat: $50-200/bln
  • Model lokal (Ollama): Gratis (perlu hardware)

Bisakah Hermes berjalan 24/7?

Ya. Deploy di VPS:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes service install
hermes service start
Enter fullscreen mode Exit fullscreen mode

Apakah Hermes cocok untuk perusahaan?

Ya. Fitur enterprise:

  • Gateway multi-user & session isolation
  • PII redaction
  • Supply chain security hardening
  • Self-hosted deployment
  • Audit logging

Cara migrasi dari OpenClaw? 

hermes claw migrate --dry-run # Preview
hermes claw migrate           # Migrasi penuh
hermes doctor                 # Verifikasi
Enter fullscreen mode Exit fullscreen mode

Bisa pakai Hermes tanpa internet?

Ya, dengan model lokal:

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b
Enter fullscreen mode Exit fullscreen mode

Apa beda Hermes vs ChatGPT?

Fitur Hermes ChatGPT
Memori Persisten, dapat dicari Hanya sesi
Penyebaran Self-hosted, 24/7 Cloud saja
Pilihan model 200+ model Hanya GPT
Ekstensibilitas Plugin, skills Terbatas
Biaya Bayar per penggunaan Berlangganan
Privasi Anda kontrol data OpenAI simpan data

Cara backup data Hermes?

Ekspor semua:

hermes export --all ~/backup/hermes-full-backup.tar.gz
Enter fullscreen mode Exit fullscreen mode

Bisakah Hermes akses file lokal saya?

Hanya file/direktori yang Anda referensikan atau beri izin. Default-nya, tidak bisa akses seluruh file system.

💡 Ingin menguji API sebagai bagian dari alur kerja pengembangan bertenaga AI Anda? Kunjungi Apidog, platform pengembangan API all-in-one untuk merancang, menguji, dan mendokumentasikan API.

Top comments (0)