🧠 Sesi 3 — Hermes Agent Mastery

Hermes Agent adalah AI agent framework open-source oleh Nous Research yang jalan di terminal, desktop app, messaging platforms, dan IDE. Satu kategori dengan Claude Code (Anthropic), Codex (OpenAI), dan OpenClaw — agent otonom yang pake tool calling untuk berinteraksi dengan sistem kamu.

Apa Bedanya?

Yang Membuat Hermes Unik

Self-improving through skills — belajar dari pengalaman, simpan sebagai skill
Persistent memory — ingat preferensi & konteks antar sesi
Multi-platform gateway — Telegram, Discord, Slack, WhatsApp, dll
Provider-agnostic — ganti model/provider kapan aja
Profiles — multiple Hermes instances dengan konfigurasi terisolasi
Open source — gratis, transparan, bisa dikustom

Profile Kamu

Setup Kamu Saat Ini

Profile: belajar-ai
Provider: DeepSeek (api.deepseek.com)
Model: deepseek-v4-flash
Platform: WebUI + Telegram (Telegam DM open)
Surface: WebUI browser
Skills: 20+ kategori terinstall

Ekosistem

Ekosistem Hermes

🧠 AIAgent — core conversation loop
⌨️ HermesCLI — terminal interface
🌐 WebUI — browser chat
🖥 Desktop App — native Electron
📡 Gateway — messaging platforms
⏰ Cron — scheduled jobs
🤝 Kanban — multi-agent work queue

2️⃣ Arsitektur & Agent Loop

🎯 Cara Kerja Hermes dari Dalam

Setiap kali kamu kirim pesan, Hermes menjalankan conversation loop yang kurang lebih gini:

run_conversation():
  1. Build system prompt — gabungin SOUL.md + AGENTS.md + skills + memory
  2. Loop while iterations < max:
     a. Call LLM (OpenAI-format messages + tool schemas)
     b. If tool_calls → dispatch each via handle_function_call()
        → append results → continue loop
     c. If text response → return to user
  3. Context compression triggers automatically near token limit

System Prompt

System Prompt = Otak Hermes

Setiap sesi, Hermes menyusun system prompt dari:

SOUL.md — identitas agen (dari ~/.hermes/)
AGENTS.md / CLAUDE.md — project rules
Skills — yang di-load via -s atau skill_view()
Memory — user profile + personal notes
Environment hints — OS, cwd, terminal backend
Tool schemas — semua tools yang aktif

Token Limit

Context Compression

Sesi bisa kepanjangan → Hermes otomatis compress context saat mendekati batas token.

threshold: 0.50 (50% dari context length)
target_ratio: 0.20 (compress sampai 20%)
Bisa manual: /compress

Max Turns

Max Turns & Timeout

max_turns: 60 (default, bisa diubah)
gateway_timeout: 1800s (30 menit)
api_max_retries: 3
/retry — ulang pesan terakhir

3️⃣ CLI Commands Lengkap

⌨️ Hermes CLI — 50+ Subcommands

Ini commands yang paling berguna buat kamu. Yang bold = paling sering dipake.

⚡ Perintah Utama

Command	Fungsi
hermes	Start interactive chat (default)
hermes chat -q "query"	One-shot query (non-interactive)
hermes --resume SESSION	Resume session by ID
hermes --continue	Resume most recent session
hermes -s skill1,skill2	Preload skills
hermes --profile NAME	Gunakan profile tertentu
hermes --yolo	Skip approval prompts

⚙️ Config & Setup

Command	Fungsi
hermes setup	Wizard setup interaktif
hermes model	Pilih model & provider
hermes config show	Lihat config.yaml
hermes config edit	Edit config.yaml di editor
hermes config set KEY VAL	Set config value
hermes config path	Print path config.yaml
hermes doctor	Cek dependencies & config
hermes status	Lihat status semua komponen

📦 Tools, Skills & Cron

Command	Fungsi
hermes tools list	Semua tools & statusnya
hermes tools enable/disable	Aktifkan/nonaktifkan toolset
hermes skills list	List installed skills
hermes skills search	Cari skill di registry
hermes skills install	Install skill baru
hermes cron list	List scheduled jobs
hermes cron create	Buat job baru
hermes cron run	Trigger job sekarang
hermes send --to telegram	Kirim pesan ke platform

👤 Profiles & Sessions

Command	Fungsi
hermes profile list	List semua profiles
hermes profile create NAME	Buat profile baru
hermes sessions list	Recent sessions
hermes sessions export	Export ke JSONL
hermes gateway run	Start messaging gateway
hermes gateway restart	Restart gateway
hermes gateway setup	Configure platforms

💡 Tips CLI

Ctrl+Enter = newline di Windows. /reset = session baru. /retry = ulang pesan terakhir. /undo = hapus exchange terakhir.

4️⃣ Slash Commands — In-Session

⚡ Ketik `/` di dalam sesi untuk akses cepat

Semua slash command ini bisa kamu ketik langsung selama chat. Yang bold paling sering dipake.

Session

Kontrol Sesi

/new — session baru
/retry — ulang pesan terakhir
/undo — hapus exchange terakhir
/title [name] — kasih nama sesi
/compress — manual compress context
/stop — kill background processes
/rollback [N] — restore checkpoint
/background [prompt] — run di background
/goal [text] — set standing goal

Config

Konfigurasi Cepat

/model [name] — ganti model mid-sesi
/reasoning [level] — set reasoning effort
/personality [name] — set personality
/verbose — cycle verbosity
/yolo — toggle approval bypass
/voice [on|off] — voice mode toggle

Tools

Tools & Skills

/skills — search/install skills
/skill [nama] — load skill ke sesi
/tools — manage tools
/cron — manage cron jobs
/plugins — list plugins
/reload-skills — re-scan skills

Info

Informasi

/usage — token usage
/insights [days] — usage analytics
/status — session info
/profile — active profile info
/history — conversation history
/debug — upload debug report

Gateway

Gateway / Platform

/approve — approve pending command (gateway)
/deny — deny pending command (gateway)
/restart — restart gateway
/sethome — set current chat as home channel
/platforms — show platform connection status
/handoff [platform] — hand session ke platform lain

5️⃣ Config Deep Dive

🔧 Semua Bisa Dikonfigurasi

Config.yaml di ~/.hermes/profiles/belajar-ai/config.yaml. Edit lewat hermes config edit.

📋 15 Section Config

Section	Key Options	Di Kamu?
model	default, provider, base_url, api_key	✅ deepseek-v4-flash
agent	max_turns (60), tool_use_enforcement (auto)	✅ default
terminal	backend (local), cwd, timeout (180)	✅ local
web	backend, search_backend, extract_backend	⚪ kosong
browser	inactivity_timeout, engine (auto)	✅ default
compression	enabled, threshold (0.50), target_ratio (0.20)	⚪ default
display	skin, interface, language, show_reasoning	⚪ default
stt	enabled, provider (local/groq/openai)	⚪ default
tts	provider (edge/elevenlabs/openai)	⚪ default
memory	memory_enabled, user_profile_enabled	✅ ON
security	tirith_enabled, redact_secrets, website_blocklist	✅ ON
delegation	model, provider, max_iterations (50)	⚪ default
checkpoints	enabled, max_snapshots (50)	❌ OFF
curator	enabled, consolidate, interval_hours	⚪ default
approvals	mode (manual/smart/off)	⚪ manual

💡 Rekomendasi Config Tuning

approvals.mode: smart — auto-approve low-risk commands, tanya kalo berbahaya. Hemat waktu!
checkpoints.enabled: true — enable filesystem checkpoint buat rollback kalo error
web.backend: set search_backend biar bisa web_search

Praktik: Cek Config Kamu

hermes config show

hermes config set approvals.mode smart

hermes config path

6️⃣ Provider & Model Management

🌐 20+ Provider Supported

Hermes bisa pake 20+ provider berbeda. Kamu bisa ganti kapan aja, bahkan mid-sesi.

Provider yang Didukung

Provider	Auth	Envy Var
DeepSeek	API key	DEEPSEEK_API_KEY ✅
OpenRouter	API key	OPENROUTER_API_KEY
Anthropic	API key	ANTHROPIC_API_KEY
OpenAI Codex	OAuth	hermes auth add openai-codex
Nous Portal	OAuth	hermes auth
Google Gemini	API key	GOOGLE_API_KEY
xAI / Grok	API key	XAI_API_KEY
Hugging Face	Token	HF_TOKEN
GitHub Copilot	OAuth	COPILOT_GITHUB_TOKEN
Custom endpoint	Config	model.base_url + api_key

Fallback Provider

Kalo primary provider error/rate limit, Hermes bisa otomatis fallback ke provider lain:

hermes fallback add anthropic

hermes fallback list

Multi API Key Pooling

Multiple API key per provider — otomatis rotate dan skip yang exhausted:

hermes auth add deepseek

hermes auth list deepseek

Praktik: Ganti Model Mid-Sesi

/model deepseek-v4-pro

/model anthropic/claude-sonnet-5 # butuh ANTHROPIC_API_KEY

7️⃣ Toolsets & Tools

🛠 25+ Toolsets — Setiap Tool = Satu Kemampuan

Tools di Hermes dikelompokkan dalam toolsets. Kamu bisa enable/disable per platform.

Toolset	Fungsi	Active?
terminal	Shell commands + process management	✅
file	Read/write/search/patch files	✅
web	Web search + content extraction	❌ (no backend)
browser	Browser automation (Browserbase/Camofox)	✅ (auto)
code_execution	Sandboxed Python execution	✅
memory	Persistent cross-session memory	✅
session_search	Search past conversations (FTS5)	✅
delegation	Subagent task delegation	✅
cronjob	Scheduled task management	✅
skills	Skill browsing & management	✅
vision	Image analysis	✅
image_gen	AI image generation	✅
clarify	Ask user clarifying questions	✅
todo	In-session task planning	✅
tts	Text-to-speech	✅

Praktik: Tools Management

hermes tools list # lihat semua tools + status

hermes tools enable web # aktifkan web search

hermes tools disable vision # nonaktifkan kalo gak perlu

# Butuh /reset setelah ganti tools

8️⃣ Skills System — Belajar dari Pengalaman

🎯 Ini Fitur Paling Powerfull di Hermes!

Skills = procedural memory. Hermes bisa nyimpen cara ngelakuin sesuatu sebagai skill, dan pake lagi di sesi berikutnya. Skills accumulate — makin sering dipake, makin pinter.

Anatomi Skill

Frontmatter

YAML Header

--- name: my-skill
description: "Apa yang skill ini lakukan"
version: 1.0.0
author: Kamu
---

Body

Markdown Instructions

Instruksi, langkah-langkah, kode, peringatan — semuanya markdown biasa. Ditulis sebagai instructions ke agent.

Linked Files

Referensi, Template, Script

Skill bisa punya file pendukung di folder-nya sendiri: references/, templates/, scripts/, assets/

📋 Skill Management

Command	Fungsi
hermes skills list	List installed skills
hermes skills search QUERY	Cari di skills hub
hermes skills install ID	Install skill
hermes skills browse	Browse semua available skills
hermes skills check	Cek update skills
hermes skills update	Update outdated skills
/skill nama-skill	Load skill ke sesi (in-session)
/reload-skills	Re-scan folder skills
hermes -s skill1,skill2	Preload skills pas startup

Praktik: Buat Skill Sendiri

# Skill: MP Horde Assistant
skill_manage(action='create', name='mp-horde-assistant', content='''
--- name: mp-horde-assistant
description: "Assistant untuk MP Horde management"
---
# MP Horde Assistant

Kamu adalah asisten untuk platform MP Horde...
...
''')

💡 Kamu Punya 20+ Kategori Skills Terinstall!

Apple, autonomous-ai-agents, blog-publisher, computer-use, creative, data-science, devops, dogfood, email, github, media, mlops, note-taking, productivity, research, smart-home, social-media, software-development, yuanbao. Makin banyak kamu pake, makin optimal!

9️⃣ Multi-Agent & Delegation

🤝 Kerjakan Banyak Hal Sekaligus

Hermes bisa spawn subagent untuk ngerjain task paralel. Ini bedanya Hermes sama chatbot biasa.

delegate_task — Subagent Cerdas

Single

Satu Task

delegate_task(
goal="Research vector database options",
context="Need for RAG app...",
)

Batch

Parallel Tasks (max 3)

delegate_task(tasks=[
{goal: "Research A", ...},
{goal: "Research B", ...},
])

Background

Background Mode

Kirim task, langsung lanjut kerja. Hasil masuk sendiri pas selesai. Gak perlu nunggu!

Perbandingan: delegate_task vs Spawn Hermes

Aspek	delegate_task	Spawning hermes
Isolasi	Separate conversation, shared process	Fully independent
Durasi	Menit (bounded by parent loop)	Jam/hari
Tool access	Subset parent tools	Full tool access
Interaktif	Tidak	Ya (PTY mode)
Guna	Quick parallel subtasks	Long autonomous missions

💡 Agent Factory Kamu Udah Multi-Agent!

Di Agent Factory, setiap agent (Absensi-8581, Chatbot-8582, Finance-8584, dll) adalah Hermes profile terpisah dengan tugas spesifik. Ini multi-agent beneran! Pake delegate_task untuk koordinasi antar agent.

🔟 Cron & Otomasi

⏰ Jadwalkan Task — Jalan Otomatis

Buat task yang jalan otomatis setiap jam/hari/minggu. Kirim hasil ke Telegram, WhatsApp, atau simpan lokal.

Cron Job Options

Parameter	Deskripsi
schedule	"30m", "every 2h", "0 9 * * *", atau ISO timestamp
prompt	Self-contained prompt yang jalan tiap tick
skills	Skills yang di-load sebelum eksekusi
deliver	Kirim hasil ke: telegram, discord, local, all, dll
model	Override model untuk job ini
script	Pre-run script untuk data collection
no_agent	True = skip LLM, langsung deliver script output
workdir	Working directory untuk project context
context_from	Chain output dari job lain

Praktik: Cron Job untuk Kamu

# Daily report MP Horde — kirim ke Telegram jam 8 pagi
cronjob(
  action='create',
  name='daily-report',
  schedule='0 8 * * *',
  prompt='Buat laporan singkat status MP Horde hari ini...',
  deliver='telegram:USER_CHAT_ID',
)

# Setiap 30 menit — cek disk usage server
cronjob(
  action='create',
  name='disk-check',
  schedule='30m',
  script='/path/to/check-disk.sh',
  no_agent=True,
)

# Kelola cron
cronjob(action='list')
cronjob(action='pause', job_id='...')
cronjob(action='remove', job_id='...')

1️⃣1️⃣ Platform Integrations

📱 Kamu Udah Terkoneksi ke Telegram!

Telegram bot kamu aktif — DM policy: open. Kamu bisa chat sama Hermes dari HP via Telegram.

20+ Platform Didukung

✅ Telegram

Bot token: terkonfigurasi
DM policy: open
Chat ID: USER_CHAT_ID

⬜ Discord

Bot + gateway support
Requires: bot token + intents

⬜ Slack

Bot + app support
Requires: bot token setup

⬜ WhatsApp

Baileys bridge + Business API
Requires: setup

🔲 Lainnya

Signal, Email, SMS, Matrix,
Teams, LINE, Google Chat,
Home Assistant, WeChat, dll

Gateway Commands

hermes gateway status

hermes gateway restart

hermes gateway setup

hermes send --to telegram "Pesan dari script"

hermes send --to telegram:USER_CHAT_ID "MEDIA:/path/file"

💡 Kirim File ke Telegram via Hermes

Pake MEDIA:/path dalam message text — Hermes otomatis upload file sebagai dokumen/gambar.

1️⃣2️⃣ Profiles — Multiple Hermes Instances

👤 Satu Profile = Satu Kepribadian

Profile mengisolasi: config, sessions, skills, memory, cron, plugins. Setiap agent di Agent Factory punya profile sendiri!

Profile Commands

Command	Fungsi
hermes profile list	List semua profiles
hermes profile create NAME	Buat baru (--clone untuk copy)
hermes profile use NAME	Set sebagai default
hermes profile show NAME	Detail profile
hermes profile rename A B	Rename profile
hermes profile export NAME	Export ke tar.gz
hermes profile import FILE	Import profile
hermes -p NAME	Gunakan profile tertentu

Profile Agents di Agent Factory Kamu

Agent	Folder	Port	Profile?
Belajar AI	agents/belajar-ai/	8591	✅ belajar-ai
Absensi	agents/absensi/	8581	✅ punya sendiri
Finance	agents/finance/	8584	✅ punya sendiri
Akunbiz	agents/akunbiz/	8590	✅ punya sendiri

1️⃣3️⃣ Memory & Sessions

🧠 Hermes Ingat Kamu Antar Sesi

Memory membuat Hermes tahu preferensi kamu, lingkungan, dan fakta penting — meskipun udah ganti sesi atau login besok.

Tipe Memory

User Profile

Siapa Kamu

Nama, preferensi, role, constraints. Di-save via memory(action='add', target='user', ...).

Personal Notes

Catatan Agent

Fakta lingkungan, tool quirks, konvensi. Di-save via memory(action='add', target='memory', ...).

Session Store

Riwayat Percakapan

SQLite + FTS5 — bisa dicari pake session_search(). Full-text search!

Memory Management

hermes memory status

hermes memory setup

hermes sessions list

hermes sessions browse

hermes sessions export ./backup.jsonl

💡 Session Search = Fitur Andalan

Lupa pernah diskusi apa? Pake session_search(query="...") — FTS5-backed, gratis (gak pake token). Bisa cari: "auth refactor", "Ollama install", "MP Horde deploy".

1️⃣4️⃣ Security & Privacy

🔴 Secret Redaction

Tool output di-scan otomatis buat API key, token, secrets — sebelum masuk context. Gak bisa dimatikan mid-sesi (sengaja — biar LLM gak bisa flip toggle sendiri).

🟡 Command Approval

Command berbahaya (rm -rf, git reset --hard) butuh approval kamu dulu. Mode: manual (selalu tanya), smart (auto-approve low-risk), off (skip semua).

🟢 PII Redaction

Di gateway, bisa hash user ID + strip nomor HP sebelum masuk context. Aktifkan: privacy.redact_pii: true.

🔵 Project Context Security

AGENTS.md / CLAUDE.md di-scan buat prompt injection patterns. Yang mencurigakan di-replace dengan [BLOCKED: ...]. Aman.

Security Config

hermes config set security.redact_secrets true

hermes config set approvals.mode smart

hermes config set privacy.redact_pii false

hermes --yolo # skip approval (sekali jalan)

1️⃣5️⃣ Troubleshooting

Masalah Umum & Solusi

Masalah	Solusi
Tool gak muncul	hermes tools → cek status → enable → /reset
Model error	hermes doctor → cek config + API key → hermes auth
Config gak berubah	/reset (sesi baru) atau restart gateway
Skills gak muncul	hermes skills list → /reload-skills
Gateway mati	Log: ~/.hermes/logs/gateway.log → hermes gateway restart
Voice gak kerja	Cek stt.enabled: true → install pip install faster-whisper
403 Copilot	gh auth login gak cukup — pake hermes model → GitHub Copilot OAuth
Session kepanjangan	/compress — manual compress context

Debugging Tools

hermes doctor # cek semua dependencies

hermes doctor --fix # auto-fix kalo ada masalah

hermes status --all

/debug # upload debug report (in-session)

grep -i "error\|failed" ~/.hermes/logs/gateway.log | tail -20

★ Use Cases untuk Bisnis Kamu

💼 Hermes Bisa Jadi Otak Bisnis Kamu

Ini cara-cara konkret pake Hermes untuk bisnis MP Horde, Absensi, dan Srkhorde.id.

📊 Daily Report MP Horde

cronjob setiap 8 pagi

Cron job tiap pagi yang ngecek database MP Horde dan kirim ringkasan ke Telegram: "Total transaksi kemarin: Rp X, Stok produk Y menipis, Leader Z belum approve absensi."

🤖 Customer Service AI

RAG Telegram

ChromaDB + data MP Horde → Hermes di Telegram jawab pertanyaan customer otomatis: "Size L harga berapa?", "Proses berapa hari?", "Ada warna merah?"

📈 SEO Otomatis

cronjob content

Cron job mingguan yang generate artikel SEO buat srkhorde.id: "Buat artikel 1000 kata tentang keyword X, tone Y." Tinggal review & publish.

🔍 Monitoring Server

no_agent alert

Cron job script yang cek disk usage, CPU, RAM tiap 30 menit. Kalo di atas 90% → kirim alert ke Telegram. No_agent mode = gratis, gak pake token.

📝 Research & Dokumentasi

delegate_task

Multi-agent parallel research. Kirim 3 subagent riset topik berbeda, kumpulin hasilnya jadi satu dokumen. Kayak sesi 2 ini — di-orkestrasi pake delegation!

🔄 Data Sync & Backup

cronjob script

Cron job script yang backup database, upload ke cloud. Jalan tiap malam jam 12. Kalo error → kirim notifikasi.

Rencana Implementasi

🐚 Pake `hermes config` & `hermes auth`

10 menit Familiar dengan semua CLI commands yang ada

📚 Eksplorasi slash commands

15 menit Coba /model, /skills, /compress, /usage

🛠 Buat skill MP Horde

30 menit Skill kustom untuk assistant MP Horde

⏰ Cron job daily report

20 menit Cron tiap pagi kirim laporan ke Telegram

🤖 Chatbot Telegram + RAG

2 jam Customer service AI via Telegram

⚡ Multi-agent automation

3 jam Agent Factory + delegate_task untuk workflow penuh

📅 24 Juli 2026 — Sesi 3: Hermes Agent Mastery

Model: DeepSeek V4 Flash | Provider: DeepSeek | Profile: belajar-ai

Sumber: hermes-agent skill (Nous Research) + docs.hermes-agent.nousresearch.com

Kembali ke belajarai.srkhorde.id · Kapanpun siap gas, panggil: "Aku mau gas skill MP Horde" 🚀