My Blog

Artikel Kedua

Tue, 28 Jul 2026 00:00:00 GMT

Artikel kedua ini menunjukkan bahwa cukup dengan menambahkan file markdown baru di folder blog/ (misalnya artikel_X.md), artikel otomatis muncul di halaman daftar blog tanpa perlu mengubah kode apa pun.

Test

Hermes Agent: Dari Instalasi sampai Implementasi

Mon, 20 Jul 2026 00:00:00 GMT

Tutorial Hermes Agent: Dari Instalasi sampai Implementasi

Hermes Agent adalah AI agent open-source (MIT License) buatan Nous Research yang berjalan di terminal, messaging platform, dan editor. Yang membedakannya dari agent CLI lain seperti Claude Code atau Codex CLI adalah dua hal: memory yang persisten antar sesi dan Skills — dokumen instruksi yang bisa dibuat otomatis dari task yang berhasil, sehingga agent makin “pintar” untuk task serupa ke depannya.

Tutorial ini membawa kamu dari instalasi kosong sampai punya agent yang jalan di terminal, bisa dihubungkan ke Telegram, dan punya skill kustom sendiri. Tutorial ini dibagi menjadi 13 halaman agar mudah diikuti selangkah demi selangkah.

Aturan main penting: jangan buru-buru aktifkan semua fitur sekaligus. Pastikan dulu chat biasa berjalan normal, baru tambahkan gateway, tools, skills, cron, atau MCP satu per satu. Ini akan menghemat waktu debugging di kemudian hari.

Daftar Isi

Chat Pertama (4/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 4 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Setelah provider terpasang, jalankan salah satu dari ini:

hermes          # antarmuka CLI klasik
hermes --tui    # antarmuka TUI modern (direkomendasikan) — ada overlay, mouse selection, input non-blocking

Kamu akan melihat welcome banner berisi model aktif, tools yang tersedia, dan skills yang terpasang.

Coba prompt yang spesifik dan gampang diverifikasi, misalnya:

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

atau

Check my current directory and tell me what looks like the main project file.

Tanda-tanda setup berhasil:

Banner menunjukkan model/provider yang benar
Hermes membalas tanpa error
Agent bisa memakai tool kalau dibutuhkan (terminal, file read, web search)
Percakapan bisa lanjut lebih dari satu giliran (multi-turn)

Kalau semua ini berjalan, bagian tersulit sudah lewat.

Bagian 4 dari 12 · ← Prev | Next →

Implementasi — Menghubungkan Bot Telegram (7/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 7 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Setelah chat dasar terbukti stabil, kamu bisa jadikan Hermes sebagai bot yang selalu aktif.

hermes gateway setup

Perintah ini interaktif dan akan memandu konfigurasi platform. Selain Telegram, gateway ini juga mendukung Discord, Slack, WhatsApp, Signal, Email, Home Assistant, dan Microsoft Teams.

Cara cek statusnya:

hermes gateway status

Contoh kasus pakai: kamu bisa punya bot Telegram pribadi yang bisa kamu tanya kapan saja — misalnya “cek disk usage server saya” atau “ringkas dokumen ini” — langsung dari HP tanpa buka terminal.

Kalau gateway sudah jalan tapi tidak ada yang bisa mengirim pesan ke bot, biasanya penyebabnya bot token, allowlist, atau setup platform belum lengkap. Jalankan ulang hermes gateway setup dan cek hermes gateway status.

Bagian 7 dari 12 · ← Prev | Next →

Implementasi — Menghubungkan MCP Server (10/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 10 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

MCP (Model Context Protocol) memungkinkan Hermes memanggil tool eksternal, misalnya integrasi langsung ke GitHub.

Tambahkan konfigurasi berikut ke ~/.hermes/config.yaml:

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Setelah disimpan, restart Hermes. Sekarang agent bisa langsung berinteraksi dengan repository GitHub kamu — misalnya membuka issue, membaca PR, atau mengecek status CI — langsung dari percakapan.

Bagian 10 dari 12 · ← Prev | Next →

Implementasi — Sandbox dengan Docker (8/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 8 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Kalau kamu memberi agent akses terminal dan file system, sebaiknya jalankan dalam sandbox agar aman dari perubahan tak terduga.

hermes config set terminal.backend docker    # isolasi via Docker
hermes config set terminal.backend ssh       # atau jalankan di remote server

Untuk keamanan tambahan saat pakai Docker, kamu bisa aktifkan egress credential-injection proxy — mekanisme ini membuat sandbox tidak pernah melihat API key asli kamu, hanya token proxy buram yang hanya berfungsi lewat daemon TLS-intercepting lokal:

hermes egress setup
hermes egress start

Contoh alur aman untuk task berisiko (misalnya minta agent membersihkan folder project lama):

Set terminal.backend ke docker
Beri akses baca ke folder tertentu saja dulu
Minta agent melakukan hal kecil dulu (misal: list file), verifikasi hasilnya
Baru beri izin lebih luas kalau sudah percaya

Bagian 8 dari 12 · ← Prev | Next →

Implementasi — Skills, Membuat Workflow Reusable (9/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 9 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Skills adalah fitur andalan Hermes: dokumen instruksi (SKILL.md) berisi nama, deskripsi, dan prosedur langkah demi langkah untuk task tertentu. Agent hanya membaca deskripsi singkatnya secara gratis, dan baru memuat isi lengkap skill saat ada task yang cocok — jadi menambah skill tidak memperberat setiap request.

Menjelajah dan menginstal skill dari komunitas

hermes skills browse                # lihat semua skill yang tersedia
hermes skills search kubernetes     # cari skill dengan kata kunci tertentu
hermes skills install openai/skills/k8s   # instal satu skill (otomatis di-scan keamanannya dulu)

Format argumen instalasi adalah source/path, misalnya openai/skills/k8s berarti skill k8s dari katalog OpenAI. Jalankan hermes skills browse untuk melihat slug yang tepat.

Memakai skill

Setiap skill yang terpasang otomatis jadi slash command:

/k8s deploy the staging manifest
/k8s

Ini berlaku baik di CLI maupun di platform messaging yang terhubung. Kamu juga tidak perlu instal semua skill di awal — agent akan otomatis memakai skill bawaan yang cocok saat percakapan berlangsung normal.

Contoh implementasi: skill kustom sederhana

Misalnya kamu sering minta agent membuat ringkasan laporan mingguan dengan format tertentu. Alih-alih menjelaskan formatnya setiap kali, kamu bisa buat skill sendiri.

Buat folder skill:

mkdir -p ~/.hermes/skills/laporan-mingguan

Buat file SKILL.md di dalamnya, berisi nama, deskripsi singkat, dan langkah-langkah format laporan yang kamu mau.
Restart sesi Hermes — skill baru akan otomatis terdeteksi dan bisa dipanggil lewat /laporan-mingguan.

Cara ini membuat workflow yang biasanya butuh instruksi panjang berulang jadi satu command singkat.

Bagian 9 dari 12 · ← Prev | Next →

Instalasi (2/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 2 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Ada dua jalur instalasi.

Opsi A — Hermes Desktop (macOS / Windows, direkomendasikan untuk pemula)

Unduh installer dari situs resmi Hermes Agent dan jalankan seperti aplikasi desktop pada umumnya. Ini akan menginstal CLI sekaligus aplikasi desktopnya.

Opsi B — CLI-only (Linux / macOS / WSL2 / Termux)

Jalankan script instalasi satu baris ini:

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

Untuk Windows native, gunakan PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Setelah instalasi selesai, reload shell agar hermes bisa dikenali sebagai command:

source ~/.bashrc   # atau source ~/.zshrc, tergantung shell yang dipakai

Cek instalasi berhasil dengan:

hermes --help

Kalau muncul daftar command, instalasi sudah beres.

Bagian 2 dari 12 · ← Prev | Next →

Memilih Provider Model (3/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 3 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Ini adalah langkah setup paling penting. Provider menentukan model AI apa yang menggerakkan agent kamu.

Cara tercepat: Nous Portal

Kalau ingin langsung jalan tanpa ribet urus API key:

hermes setup --portal

Perintah ini login lewat OAuth, otomatis set Nous sebagai provider, dan mengaktifkan Tool Gateway (web search, image generation, TTS, cloud browser) dalam satu langkah.

Cara interaktif: pilih provider sendiri

hermes model

Perintah ini akan menuntunmu memilih provider secara interaktif. Beberapa opsi populer:

Provider	Cara setup
Nous Portal	OAuth via `hermes model`, tanpa API key
Anthropic (Claude)	OAuth (butuh Max plan + kredit tambahan), atau set API key
OpenAI Codex	Device code auth via `hermes model`
OpenRouter	Masukkan API key
Custom Endpoint (Ollama, vLLM, dll)	Set base URL + API key

Tiga mode setup

Saat instalasi baru, hermes setup menawarkan tiga mode:

Quick Setup (Nous Portal) — jalur tercepat, tanpa API key.
Full Setup — kamu jalan lewat semua provider dan opsi secara manual, pakai API key sendiri.
Blank Slate — semua fitur nonaktif kecuali dasar minimum (provider, model, File Operations, Terminal). Cocok kalau kamu mau kontrol penuh dan hanya mengaktifkan fitur yang benar-benar dibutuhkan.

Menyimpan konfigurasi manual

Hermes memisahkan secret (token/API key) dari config biasa:

Secret & token → ~/.hermes/.env
Setting non-secret → ~/.hermes/config.yaml

Cara paling aman mengubahnya lewat CLI, bukan edit file langsung:

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-xxxxxxxx

Hermes otomatis tahu harus menyimpan value ke file yang tepat.

Bagian 3 dari 12 · ← Prev | Next →

Mengenal Fitur Inti (6/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 6 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Menjalankan perintah terminal lewat agent

❯ What's my disk usage? Show the top 5 largest directories.

Agent akan menjalankan command terminal atas nama kamu dan menampilkan hasilnya.

Slash commands

Ketik / untuk melihat daftar command yang tersedia:

Command	Fungsi
`/help`	Menampilkan semua command
`/tools`	Daftar tool yang tersedia
`/model`	Ganti model secara interaktif
`/personality pirate`	Coba personality lain (fitur hiburan)
`/save`	Simpan percakapan

Input multi-baris

Tekan Alt+Enter atau Ctrl+J untuk baris baru (bekerja di semua terminal). Shift+Enter juga bisa, tapi tergantung dukungan terminal (Kitty, WezTerm, Ghostty secara default).

Menginterupsi agent

Kalau agent kelamaan mengerjakan sesuatu, cukup ketik pesan baru dan tekan Enter — ini akan menginterupsi task yang sedang jalan dan beralih ke instruksi barumu. Ctrl+C juga bisa dipakai.

Bagian 6 dari 12 · ← Prev | Next →

Prasyarat (1/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 1 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Sebelum mulai, pastikan:

OS: Linux, macOS, WSL2, Windows (native), atau Android via Termux.
Model dengan context minimal 64.000 token. Model dengan context window lebih kecil akan ditolak saat startup karena tidak cukup untuk menyimpan working memory dalam alur tool-calling yang panjang. Mayoritas model populer (Claude, GPT, Gemini, Qwen, DeepSeek) sudah memenuhi syarat ini.
Akun provider (opsional di awal) — bisa pakai Nous Portal (gratis, OAuth, tanpa API key) atau bawa API key sendiri dari provider seperti Anthropic, OpenAI, OpenRouter, dsb.

Bagian 1 dari 12 · ← Prev | Next →

Referensi Cepat & Langkah Selanjutnya (12/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 12 dari 12 (terakhir) seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Referensi Cepat

Command	Fungsi
`hermes`	Mulai chat
`hermes --tui`	Mulai chat dengan antarmuka TUI
`hermes model`	Pilih provider dan model
`hermes tools`	Atur tool mana yang aktif per platform
`hermes setup`	Wizard setup lengkap
`hermes doctor`	Diagnosis masalah
`hermes update`	Update ke versi terbaru
`hermes gateway setup`	Konfigurasi platform messaging
`hermes gateway status`	Cek status gateway
`hermes skills browse`	Jelajahi skill yang tersedia
`hermes skills install <slug>`	Instal skill dari hub
`hermes --continue` / `hermes -c`	Lanjutkan sesi terakhir
`hermes sessions list`	Daftar semua sesi
`hermes config set <key> <value>`	Ubah konfigurasi

Langkah Selanjutnya

Setelah tutorial ini, beberapa arah lanjutan yang bisa dieksplorasi:

Cron & automasi: jadwalkan task rutin, tapi hanya setelah setup bot/CLI stabil.
Voice mode: install extras .[voice] untuk speech-to-text lokal gratis, aktifkan lewat /voice on.
Multi-agent / delegasi: menjalankan beberapa subagent paralel untuk task kompleks.
Editor integration (ACP): hubungkan Hermes langsung ke editor kode via hermes acp.

Sumber utama: dokumentasi resmi Hermes Agent oleh Nous Research.

Bagian 12 dari 12 · ← Prev | Kembali ke Pengenalan & Daftar Isi

Troubleshooting (11/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 11 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Kalau ada yang terasa tidak beres, ikuti urutan pemulihan ini:

hermes doctor          # 1. diagnosis masalah konfigurasi
hermes model           # 2. cek ulang provider & model
hermes setup           # 3. jalankan ulang wizard setup
hermes sessions list    # 4. cek daftar sesi
hermes --continue      # 5. coba resume sesi
hermes gateway status  # 6. cek status gateway (kalau pakai bot)

Masalah umum

Gejala	Kemungkinan penyebab	Solusi
Hermes jalan tapi balasan kosong/error	Auth provider atau pemilihan model salah	Jalankan `hermes model` ulang, cek provider, model, dan auth
Custom endpoint “jalan” tapi hasilnya ngaco	Base URL/nama model salah, atau endpoint tidak benar-benar OpenAI-compatible	Uji endpoint di client terpisah dulu
Gateway aktif tapi tidak ada yang bisa chat ke bot	Token bot, allowlist, atau setup platform belum lengkap	Jalankan ulang `hermes gateway setup`, cek `hermes gateway status`
`hermes --continue` tidak menemukan sesi lama	Ganti profile, atau sesi memang belum tersimpan	Cek `hermes sessions list`, pastikan profile yang benar
Model unavailable / fallback aneh	Routing provider atau fallback terlalu agresif	Matikan routing dulu sampai provider dasar stabil

Bagian 11 dari 12 · ← Prev | Next →

Verifikasi Sesi (5/12)

Mon, 20 Jul 2026 00:00:00 GMT

Bagian 5 dari 12 seri Tutorial Hermes Agent: Dari Instalasi sampai Implementasi.

Sebelum lanjut ke fitur lain, pastikan fitur resume sesi berfungsi:

hermes --continue    # lanjutkan sesi terakhir
hermes -c            # bentuk singkatnya

Kalau tidak kembali ke sesi sebelumnya, cek apakah kamu masih di profile yang sama, atau cek dengan:

hermes sessions list

Ini penting terutama kalau nanti kamu punya banyak setup atau bekerja lintas mesin.

Bagian 5 dari 12 · ← Prev | Next →