Cara Menggunakan Hermes Agent

TL;DR: Hermes Agent adalah asisten AI sumber terbuka yang mengingat apa yang dipelajarinya dan menjadi lebih pintar seiring waktu. Instal dengan satu perintah, konfigurasikan penyedia LLM Anda, dan mulai mengobrol melalui CLI, Telegram, Discord, atau IDE Anda. Panduan ini mencakup instalasi, pengaturan, penggunaan sehari-hari, fitur-fitur canggih, dan cara mendapatkan hasil maksimal dari Hermes.

tombol

Apa itu Hermes Agent?

Hermes Agent adalah asisten AI pribadi yang dibuat oleh NousResearch yang berjalan 24/7, mengingat semua yang dipelajarinya, dan semakin cakap seiring waktu. Tidak seperti ChatGPT atau Claude yang memulai setiap percakapan dari awal, Hermes membangun model yang persisten dari pekerjaan, proyek, dan preferensi Anda.

Kemampuan utama:

Mengingat — Menyimpan percakapan, keputusan, dan kode yang telah Anda tulis
Belajar — Menciptakan keterampilan yang dapat digunakan kembali dari tugas berulang
Multi-platform — Mengobrol melalui CLI, Telegram, Discord, Slack, WhatsApp, atau IDE
Self-hosted — Berjalan di laptop Anda, VPS $5, atau infrastruktur cloud
Agnostik model — Gunakan 200+ model melalui OpenRouter atau penyedia langsung
Dapat diperluas — Sistem plugin untuk alat dan perintah kustom

Siapa yang harus menggunakan Hermes:

Pengembang yang menginginkan pasangan pemrogram AI yang memahami codebase mereka
Tim yang membutuhkan asisten AI bersama dengan dukungan multi-pengguna
Pengguna mahir yang menginginkan otomatisasi agen 24/7 melalui penjadwalan cron
Peneliti yang melatih model AI kustom dengan data trajectory

Instalasi: Langkah demi Langkah

Prasyarat

Sistem Operasi: macOS, Linux, atau Windows (WSL direkomendasikan)
Python: 3.10 atau lebih tinggi
Git: Untuk mengkloning repositori
Kunci API: OpenRouter, Anthropic, OpenAI, atau penyedia LLM lainnya

Instalasi Cepat (Direkomendasikan)

Cara tercepat untuk menginstal Hermes:

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

Skrip ini:

Mengkloning repositori Hermes
Menginstal uv (manajer paket Python cepat)
Membuat lingkungan virtual
Menginstal semua dependensi
Menambahkan Hermes ke PATH Anda

Setelah instalasi, muat ulang shell Anda:

source ~/.bashrc # Untuk bash
source ~/.zshrc # Untuk zsh

Verifikasi instalasi:

hermes --version

Anda akan melihat sesuatu seperti Hermes Agent v0.5.0.

Instalasi Manual (Untuk Pengembang)

Jika Anda menginginkan kontrol lebih atas instalasi:

# Kloning repositori
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

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

# Buat dan aktifkan lingkungan virtual
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 pengujian untuk memverifikasi instalasi
python -m pytest tests/ -q

Instalasi dengan Dukungan Pelatihan RL

Jika Anda berencana untuk melatih model kustom:

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

# Instal dengan dependensi pelatihan
uv pip install -e "./tinker-atropos"

Pengaturan dan Konfigurasi Awal

Jalankan Wizard Pengaturan

Pengguna pertama kali harus menjalankan pengaturan interaktif:

hermes setup

Wizard akan memandu Anda melalui:

Memilih penyedia LLM Anda — OpenRouter, Anthropic, OpenAI, dll.
Mengatur kunci API — Disimpan dengan aman di ~/.hermes/.env
Mengkonfigurasi memori — Mengaktifkan/menonaktifkan memori persisten
Backend terminal — Opsi lokal, Docker, SSH, atau cloud
Pengaturan Gateway — Integrasi Telegram, Discord, Slack (opsional)

Konfigurasi Manual

Jika Anda lebih suka pengaturan manual, edit file konfigurasi:

hermes config edit

Atau gunakan perintah CLI:

# Atur model default
hermes config set model anthropic/claude-opus-4

# Atur backend terminal
hermes config set terminal.backend local

# Atur kunci API (otomatis menyimpan ke ~/.hermes/.env)
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Lokasi File Konfigurasi

Hermes menyimpan konfigurasi di ~/.hermes/:

~/.hermes/
├── config.yaml # Konfigurasi utama
├── .env # Kunci API (jangan bagikan!)
├── memory/ # Penyimpanan memori persisten
├── skills/ # Keterampilan yang terinstal
└── plugins/ # Plugin kustom

Verifikasi Pengaturan Anda

Jalankan pemeriksaan kesehatan:

hermes doctor

Ini memeriksa:

Validitas konfigurasi
Konektivitas kunci API
Status sistem memori
Status gateway (jika diaktifkan)
Koneksi backend terminal

Memilih Penyedia LLM Anda

Hermes mendukung 200+ model melalui beberapa penyedia. Berikut cara memilihnya:

OpenRouter (Direkomendasikan untuk Pemula)

Mengapa: Satu kunci API memberikan akses ke 200+ model. Tersedia tingkatan gratis.

Pengaturan:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

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`	Jendela konteks panjang	$
`meta/llama-3-70b`	Sumber terbuka, cepat	$

Anthropic Langsung

Mengapa: Pengkodean dan penalaran terbaik di kelasnya. Akses langsung ke model Claude terbaru.

Pengaturan:

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Langsung

Mengapa: Model GPT-4o dan o1 untuk kasus penggunaan tertentu.

Pengaturan:

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

Model Lokal (Ollama)

Mengapa: Gratis, pribadi, mampu offline.

Pengaturan:

# Instal Ollama terlebih dahulu: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Contoh Konfigurasi Model

Perutean cerdas (model mahal untuk tugas kompleks, murah untuk yang sederhana):

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

Kontrol biaya (menetapkan batas pengeluaran):

model:
  budget:
    daily_limit: 5.00 # USD
    monthly_limit: 100.00

Penggunaan Dasar: Mode CLI

Memulai Hermes

Cara termudah untuk menggunakan Hermes:

hermes

Anda akan melihat spanduk selamat datang dan dapat langsung mulai mengobrol.

Perintah Dasar

Di dalam Hermes, Anda dapat:

Mengobrol secara alami:

> Hai, bisakah Anda membantu saya menulis fungsi Python untuk menguraikan JSON?

Gunakan perintah slash:

> /help # Tampilkan semua perintah
> /skills # Jelajahi keterampilan yang tersedia
> /memory # Lihat status memori
> /config # Lihat/edit konfigurasi
> /clear # Hapus percakapan saat ini
> /history # Lihat percakapan sebelumnya

Berikan tugas berbasis file:

> Lihat file ./src/main.py dan refaktor koneksi database

Jalankan perintah terminal:

> Jalankan: npm install && npm run build

Hermes akan meminta konfirmasi sebelum mengeksekusi perintah apa pun.

Shell Persisten

Tidak seperti alat AI lainnya, Hermes mempertahankan status shell di seluruh perintah:

> cd /my/project && source venv/bin/activate
> python src/main.py # Berjalan dalam sesi shell yang sama

Lingkungan virtual tetap aktif untuk perintah selanjutnya.

Bekerja dengan File

Baca file:

> Tunjukkan isi config.yaml

Edit file:

> Di main.py, ubah port database dari 5432 menjadi 5433

Buat file baru:

> Buat file baru bernama utils.py dengan fungsi pembantu untuk pemformatan tanggal

Alur Kerja Multi-Langkah

Hermes unggul dalam tugas-tugas kompleks multi-langkah:

> Saya perlu menambahkan otentikasi pengguna ke aplikasi Flask saya. Bisakah Anda:
> 1. Menyiapkan model database
> 2. Membuat endpoint login/logout
> 3. Menambahkan pembuatan token JWT
> 4. Menulis pengujian untuk alur otentikasi

Hermes akan bekerja melalui setiap langkah, meminta konfirmasi di sepanjang jalan.

Gateway Pesan: Telegram, Discord, Slack

Hermes dapat berjalan sebagai bot di berbagai platform pesan, sehingga Anda dapat berinteraksi dengannya dari ponsel atau obrolan tim Anda.

Pengaturan Telegram

1. Buat bot:

Buka Telegram dan cari @BotFather
Kirim /newbot dan ikuti petunjuk
Salin token bot

2. Konfigurasi Hermes:

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. Mulai gateway:

hermes gateway setup telegram
hermes gateway start

4. Mulai mengobrol:

Temukan bot Anda di Telegram
Kirim /start
Mengobrol seperti yang Anda lakukan di CLI

Pengaturan Discord

1. Buat aplikasi Discord:

Pergi ke https://discord.com/developers/applications
Buat aplikasi baru
Pergi ke bagian "Bot" dan buat bot
Salin token bot

2. Undang bot ke server Anda:

Pergi ke "OAuth2" → "URL Generator"
Pilih cakupan "bot"
Salin URL yang dihasilkan dan buka

3. Konfigurasi Hermes:

hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

4. Gunakan di Discord:

Sebutkan bot: @Hermes bantu saya menulis fungsi...
Atau gunakan di DM

Pengaturan Slack

1. Buat aplikasi Slack:

Pergi ke https://api.slack.com/apps
Buat aplikasi baru dari awal
Tambahkan izin "Bot"

2. Instal ke ruang kerja dan salin token

3. Konfigurasi Hermes:

hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Penggunaan Multi-Platform

Anda dapat menjalankan beberapa gateway secara bersamaan:

hermes gateway start --all

Hermes menyinkronkan status percakapan di semua platform.

Integrasi IDE: VS Code, JetBrains

Hermes berintegrasi langsung dengan editor kode Anda melalui Agent Communication Protocol (ACP).

Integrasi VS Code

1. Instal ekstensi ACP:

Buka VS Code
Pergi ke Ekstensi (Ctrl+Shift+X)
Cari "Agent Communication Protocol"
Instal ekstensi

2. Konfigurasi Hermes sebagai backend:

hermes acp start

3. Gunakan di VS Code:

Buka bilah samping ACP
Pilih Hermes sebagai agen Anda
Mengobrol dan menggunakan perintah slash langsung di editor

Integrasi JetBrains (IntelliJ, PyCharm, dll.)

1. Instal plugin ACP:

Buka Pengaturan → Plugin
Cari "ACP" atau "Agent Communication Protocol"
Instal dan restart IDE

2. Mulai server ACP Hermes:

hermes acp start

3. Konfigurasi di JetBrains:

Pergi ke Pengaturan → Alat → Agen AI
Tambahkan Hermes sebagai backend ACP
Uji koneksi

Editor Zed

Zed memiliki dukungan ACP asli:

1. Konfigurasi di pengaturan Zed:

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}

2. Mulai Hermes:

hermes acp start

Sistem Memori dan Pembelajaran

Kekuatan super Hermes adalah arsitektur memorinya. Berikut cara menggunakannya secara efektif.

Jenis Memori

Memori Episodik: Menyimpan percakapan dan sesi tertentu. Anda dapat mencari dan mengambil interaksi sebelumnya.

> /memory search "migrasi database"

Memori Semantik: Membangun grafik pengetahuan tentang proyek, preferensi, dan pola Anda.

> /memory projects

Memori Prosedural (Keterampilan): Menciptakan keterampilan yang dapat digunakan kembali dari tugas berulang.

> /skills list

Pencarian Sesi

Temukan pekerjaan sebelumnya yang relevan dengan pencarian semantik:

> /memory search "Bagaimana kita menangani kedaluwarsa JWT minggu lalu?"

Hermes mencari seluruh riwayat Anda dan meringkas hasilnya.

Dorongan Memori

Hermes secara proaktif menampilkan informasi yang relevan:

[Hermes]: Saya melihat Anda sedang mengerjakan sistem otentikasi. Selasa lalu Anda
menyebutkan masalah dengan kedaluwarsa JWT. Ingin meninjau kembali itu?

Kompresi Konteks

Hermes secara otomatis mengompres konteks untuk menghindari batas:

Kompresi Gateway pada penggunaan konteks 85%
Kompresi tingkat agen pada 50% (dapat dikonfigurasi)

Ini memungkinkan percakapan tanpa batas tanpa manajemen konteks manual.

Ekspor dan Cadangkan

Ekspor memori:

hermes memory export ~/backup/hermes-memory.json

Impor memori:

hermes memory import ~/backup/hermes-memory.json

Keterampilan dan Plugin

Apa Itu Keterampilan?

Keterampilan adalah alur kerja yang dapat digunakan kembali yang dapat dieksekusi Hermes. Anggap saja sebagai makro untuk tugas-tugas kompleks.

Keterampilan bawaan meliputi:

code_review — Tinjau kode untuk bug dan gaya
debug_session — Alur kerja debugging sistematis
api_tester — Uji API REST/GraphQL
git_workflow — Operasi Git dengan praktik terbaik
documentation — Hasilkan dokumen dari kode

Jelajahi dan Instal Keterampilan

Lihat keterampilan yang tersedia:

> /skills list

Instal keterampilan:

> /skills install code_review

Gunakan keterampilan:

> /skills run code_review ./src/auth.py

Keterampilan Kustom

Buat keterampilan kustom 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 keterampilan Anda di sini
        return "Keterampilan berhasil dieksekusi"

Sistem Plugin

Plugin memperluas Hermes dengan alat, perintah, dan kait kustom.

Buat 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 di sini
        return {"result": "sukses"}

Jenis plugin:

Alat — Kemampuan baru yang dapat digunakan agen
Perintah — Perintah slash baru
Kait — Penangan peristiwa siklus hidup (sebelum/sesudah giliran)

Fitur Lanjutan

Penjadwalan Cron

Jadwalkan tugas otomatis:

# Minta Hermes untuk membuat tugas terjadwal
> Atur ringkasan harian notifikasi GitHub saya pada pukul 9 pagi

Atau konfigurasikan secara manual di config.yaml:

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

Delegasi Subagen

Hermes dapat melahirkan subagen untuk pekerjaan paralel:

> Saya perlu Anda meninjau semua PR di repositori saya dan meringkas perubahannya

Hermes akan melahirkan beberapa subagen untuk bekerja secara paralel, lalu mensintesis hasilnya.

Mode Suara

Tekan-untuk-bicara di CLI:

hermes --voice

Catatan suara di Telegram/Discord:

Kirim pesan suara
Hermes mentranskripsi dan merespons

Saluran suara Discord:

Hermes dapat bergabung dengan saluran suara
Berbicara dan mendengarkan secara real-time

Kontrol Browser

Hermes berintegrasi dengan Browser Use CLI 2.0 untuk otomatisasi web:

> Pergi ke github.com dan temukan 5 repositori Python terpopuler

Atau sambungkan ke Chrome langsung melalui CDP:

hermes browser connect --cdp

Integrasi MCP

Hermes mendukung server Model Context Protocol (MCP):

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

Mode Worktree

Jalankan Hermes dalam worktree git yang terisolasi:

hermes -w

Beberapa agen dapat bekerja pada repositori yang sama secara bersamaan tanpa konflik.

Jalankan Agen Lain di Dalam Hermes

Hermes dapat menjalankan agen AI lain sebagai subagen:

> Gunakan claude-code untuk meninjau permintaan tarik ini

Ini berguna untuk memanfaatkan agen khusus untuk tugas-tugas tertentu.

Pemecahan Masalah

Masalah Umum

"Kunci API tidak ditemukan"

# Verifikasi kunci API telah diatur
hermes config get OPENROUTER_API_KEY

# Atur ulang jika diperlukan
hermes config set OPENROUTER_API_KEY sk-or-...

"Model tidak tersedia"

# Daftar model yang tersedia
hermes models list

# Ubah model
hermes config set model anthropic/claude-opus-4

"Gateway gagal dimulai"

# Periksa status gateway
hermes gateway status

# Restart gateway
hermes gateway stop
hermes gateway start

"Kerusakan memori terdeteksi"

# Cadangkan memori saat ini
hermes memory export ~/backup/memory-backup.json

# Reset memori
hermes memory reset

# Impor ulang jika diperlukan
hermes memory import ~/backup/memory-backup.json

Mendapatkan Bantuan

Bantuan bawaan:

> /help

Lihat log:

hermes logs tail --follow

Jalankan diagnostik:

hermes doctor

FAQ

Berapa biaya untuk menjalankan Hermes?

Hermes itu sendiri gratis. Anda hanya membayar untuk penggunaan LLM. Biaya umum:

Penggunaan ringan (beberapa tugas/hari): $5-15/bulan dengan OpenRouter
Penggunaan sedang (pengembangan reguler): $20-50/bulan
Penggunaan berat (otomatisasi 24/7): $50-200/bulan

Menggunakan model lokal (Ollama) gratis tetapi membutuhkan perangkat keras.

Bisakah Hermes berjalan 24/7?

Ya. Sebarkan Hermes di VPS:

# Instal di VPS
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Jalankan sebagai layanan systemd
hermes service install
hermes service start

Apakah Hermes cocok untuk penggunaan perusahaan?

Ya. Fitur perusahaan meliputi:

Mode gateway multi-pengguna dengan isolasi sesi
Redaksi PII untuk kepatuhan
Pengerasan keamanan rantai pasokan
Penyebaran yang dihosting sendiri
Pencatatan audit

Bagaimana cara bermigrasi dari OpenClaw?

hermes claw migrate --dry-run # Pratinjau
hermes claw migrate # Migrasi penuh
hermes doctor # Verifikasi

Bisakah saya menggunakan Hermes tanpa internet?

Ya, dengan model lokal:

# Instal Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Tarik model
ollama pull qwen2.5-coder:32b

# Konfigurasi Hermes
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Apa perbedaan antara Hermes dan ChatGPT?

Fitur	Hermes	ChatGPT
Memori	Persisten, dapat dicari	Hanya sesi
Penyebaran	Dihosting sendiri, 24/7	Hanya cloud
Pilihan model	200+ model	Hanya GPT
Ekstensibilitas	Plugin, keterampilan	Terbatas
Biaya	Bayar hanya untuk penggunaan	Berlangganan
Privasi	Anda mengontrol data	OpenAI menyimpan data

Bagaimana cara mencadangkan data Hermes saya?

# Ekspor semuanya
hermes export --all ~/backup/hermes-full-backup.tar.gz

Bisakah Hermes mengakses file lokal saya?

Hermes hanya dapat mengakses file yang Anda referensikan secara eksplisit atau direktori yang telah Anda berikan izinnya. Secara default, ia tidak memiliki akses ke sistem file Anda.

💡

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.

tombol