Bangun agent yang benar-benar dapat bekerja.

Sebelum memulai

Hermes berjalan di Linux, macOS, Windows/WSL2, dan Android melalui Termux. Installer resmi menyiapkan Python, uv, environment terisolasi, dan launcher secara otomatis.

Pilih tempat Hermes berjalan

Gunakan ponsel untuk eksperimen, komputer untuk pekerjaan harian, atau VPS ketika agent harus selalu online.

Pilihan VPS hemat

VPS bersifat opsional, tetapi hanya VPS yang membuat gateway, cron job, dan webhook tetap hidup tanpa bergantung pada laptop atau ponsel. Harga di bawah adalah tier awal indikatif — selalu periksa harga, region, batas bandwidth, dan ketentuan layanan terbaru di situs penyedia sebelum membeli.

Setup Termux

Termux adalah jalur Android praktis untuk instalasi Hermes portable. Instal dari F-Droid atau GitHub—bukan versi Play Store lama—lalu jaga perangkat tetap aktif saat gateway berjalan.

pkg update -y
pkg install git python -y
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
termux-wake-lock

Yang berfungsi dan yang tidak

Masalah Termux yang sering muncul

Instal Hermes Agent

Shell installer adalah jalur yang disarankan di Linux, macOS, WSL2, dan Termux. Pengguna Windows native dapat memasang package Python melalui PowerShell.

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

pip install hermes-agent
hermes setup
hermes doctor

Setup provider AI

Hermes bebas provider. Pilih provider dan model secara interaktif, lalu kelola API key atau credential OAuth melalui auth manager.

hermes model
hermes auth
hermes auth add openrouter
hermes auth list

Jalankan chat pertama

Validasi agent lokal sebelum menambahkan platform pesan. Respons sukses memastikan model, provider, dan credential bekerja bersama.

hermes chat -q "Introduce yourself in one sentence."
hermes sessions list

Konfigurasi dan tools

Gunakan CLI daripada menebak key konfigurasi secara manual. Rahasia disimpan di ~/.hermes/.env; pengaturan durable disimpan di ~/.hermes/config.yaml. Perubahan tools dimuat pada sesi berikutnya.

hermes config
hermes config check
hermes config path
hermes config env-path
hermes tools list
hermes tools enable web

Sesi dan konteks proyek

Hermes menyimpan sesi di SQLite dengan riwayat yang dapat dicari. Resume, branch, rename, export, atau prune percakapan sambil memisahkan aturan proyek dari personality.

hermes sessions list
hermes sessions browse
hermes sessions export sessions.jsonl
hermes --continue

Free tier dan akses murah

Limit provider sering berubah. Perlakukan free tier sebagai eksperimental, konfirmasi limit terbaru di situs resmi, dan siapkan fallback untuk pekerjaan penting.

Router dengan kredit awal gratis

Layanan berikut adalah pihak ketiga, bukan integrasi resmi Hermes. Semuanya menyediakan endpoint yang kompatibel dengan OpenAI atau Anthropic sehingga dapat dipakai Hermes sebagai custom provider. Besaran kredit dan katalog model sering berubah — anggap setiap angka di bawah sebagai titik awal yang wajib diverifikasi di dashboard penyedia.

Arahkan Hermes ke router kompatibel OpenAI

# 1. Daftar, buat key, dan salin base URL persis dari dashboard
# 2. Simpan kredensial, lalu pilih model secara interaktif
hermes config set OPENAI_BASE_URL https://api.example-router.ai/v1
hermes config set OPENAI_API_KEY sk-key-anda
hermes model
hermes chat -q "Balas OK jika router ini berfungsi."

Router kompatibel Anthropic

export ANTHROPIC_BASE_URL="https://agentrouter.org/"
export ANTHROPIC_AUTH_TOKEN="sk-key-anda"
export ANTHROPIC_API_KEY="sk-key-anda"

Router dan gateway terpadu

Layanan ini opsional. Tinjau privasi, reliabilitas, harga terbaru, dan model yang tersedia sebelum mengirim traffic production atau sensitif.

9Router

9Router menampilkan provider yang terhubung melalui endpoint kompatibel OpenAI. Instal hanya jika memerlukan lapisan routing terpisah; Hermes sudah dapat terhubung langsung ke banyak provider.

npm install -g 9router
9router

Opsi deployment

Jalankan, verifikasi, lalu hubungkan

# Jalankan router, pastikan merespons sebelum menyentuh Hermes
curl -s http://127.0.0.1:20128/v1/models | head

# Arahkan Hermes ke router lokal
hermes config set OPENAI_BASE_URL http://127.0.0.1:20128/v1
hermes config set OPENAI_API_KEY key-router-anda
hermes model

FreeLLMAPI

FreeLLMAPI adalah gateway open-source pihak ketiga. Tinjau source, konektor yang didukung, dan model keamanannya sebelum deployment; perilaku provider gratis dapat berubah tanpa pemberitahuan.

git clone https://github.com/tashfeenahmed/freellmapi.git
cd freellmapi
docker compose up -d

Fungsi utamanya

FreeLLMAPI menggabungkan beberapa konektor provider gratis di balik satu endpoint kompatibel OpenAI. Ini perangkat lunak komunitas: baca repository, periksa daftar konektor, dan kunci pada commit yang Anda kenal sebelum mengandalkannya.

Deployment container

# Tinjau docker-compose.yml lebih dulu, baru jalankan
docker compose up -d
docker compose logs -f --tail 50

# Pastikan endpoint merespons
curl -s http://127.0.0.1:3000/v1/models | head

Unimodel

Unimodel menyediakan satu API hosted untuk banyak model AI. Buat akun, salin base URL dan API key terbaru dari dashboard, lalu tambahkan sebagai provider custom kompatibel OpenAI di Hermes. Nama model dan limit free tier dapat berubah, jadi gunakan dashboard sebagai sumber kebenaran.

hermes model
# Pilih endpoint custom kompatibel OpenAI
# Masukkan base URL Unimodel, API key, dan model ID persis dari dashboard

Setup langkah demi langkah

Konfigurasi Unimodel sebagai custom provider

# Base URL dan key diambil dari dashboard Unimodel
hermes config set OPENAI_BASE_URL https://www.unimodel.ai/v1
hermes config set OPENAI_API_KEY sk-uni-key-anda

# Atau export hanya untuk shell saat ini
export OPENAI_BASE_URL="https://www.unimodel.ai/v1"
export OPENAI_API_KEY="sk-uni-key-anda"

# Verifikasi
curl -s $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" | head
hermes model
hermes chat -q "Balas OK."

Keluarga model yang umum tersedia

Hubungkan Telegram

Hubungkan platform pesan hanya setelah chat lokal bekerja. Batasi akses ke user ID yang diizinkan agar bot publik tidak menghabiskan kuota provider.

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Platform lainnya

Hermes mendukung lebih dari 20 platform pesan dan gateway. Ketersediaan serta kebutuhan setup berbeda pada setiap adapter.

Operasi dan keamanan gateway

Adapter platform pesan memiliki kemampuan agent penuh, sehingga kontrol akses penting. Gunakan allowlist atau pairing, redaksi rahasia, dan pemeriksaan approval untuk command destruktif.

hermes gateway status
hermes gateway restart
hermes pairing list
hermes status --all

Perluas kemampuan agent

Setelah alur inti stabil, tambahkan voice, otomatisasi, skill, integrasi MCP, profile, webhook, dan konteks proyek yang tahan lama.

Memory dan profile

Memory menyimpan konteks user dan environment yang durable; profile mengisolasi instance Hermes lengkap. Jangan campur memory, aturan proyek, dan SOUL.md karena fungsinya berbeda.

hermes memory status
hermes profile list
hermes profile create research
hermes auth list

MCP, plugin, webhook, dan hook

Perluas Hermes tanpa mengedit core. Hubungkan MCP server, instal plugin, subscribe route webhook, atau tambahkan lifecycle hook.

hermes mcp list
hermes mcp add NAME --url https://example.com/mcp
hermes plugins list
hermes webhook list

Mode suara

Voice masuk dapat ditranskripsikan dengan faster-whisper lokal atau provider hosted. TTS dapat menggunakan Edge TTS atau provider komersial yang dikonfigurasi.

/voice on     # voice-to-voice
/voice tts    # selalu jawab dengan audio
/voice off    # nonaktifkan output suara

Cron dan pekerjaan terjadwal

Gunakan job durable untuk briefing, reminder, monitoring, dan pengumpulan berbasis script. Uji output secara manual sebelum mengaktifkan jadwal production.

hermes cron list
hermes cron create "every 2h"
hermes cron status

Skill dan workflow reusable

Skill mengemas prosedur, referensi, template, script, dan aset. Periksa skill pihak ketiga sebelum menginstalnya dan simpan hanya yang dibutuhkan workflow Anda.

hermes skills browse
hermes skills search telegram
hermes skills inspect <skill-id>
hermes skills install <skill-id>

Tempat mencari skill

Skill adalah prosedur yang portabel. Selain katalog resmi, ada dua hub komunitas yang mengindeks skill pihak ketiga. Baca dulu sebelum memasang: sebuah skill dapat menjalankan perintah di mesin Anda.

SOUL.md dan personality

SOUL.md defines durable identity, tone, and boundaries. Keep it declarative, concise, and free of temporary tasks or secrets.

# My Agent

I communicate clearly, protect private data, verify facts with tools, and ask before destructive actions.

Empat tier personality

Pilih tier sesuai tingkat otonomi yang benar-benar Anda inginkan. Mulai dari yang konservatif lalu perluas kemudian — filenya Markdown biasa dan berlaku pada sesi berikutnya.

Tier 1 — Basic

# SOUL.md

## Identity
I am a careful, helpful assistant.

## Communication
- Answer the question directly, then add context if useful.
- Match the language the user writes in.
- When a request is ambiguous, ask one clear question.

## Boundaries
- Confirm before deleting, overwriting, or sending anything externally.
- Never print secrets, tokens, or private paths.

Tier 2 — Pro

# SOUL.md

## Identity
I am an execution-focused engineering assistant.

## Traits
Direct. Concrete. Verifiable.

## Communication
- Lead with the answer or the command; keep explanation short.
- Reference exact file paths and commands.
- No filler, no motivational language, no unnecessary disclaimers.

## Working style
- Verify results with a real check instead of assuming success.
- Ask only when a decision has a real trade-off.

## Boundaries
- Confirm before destructive or irreversible operations.
- Keep credentials out of output and out of version control.

Tier 3 — Expert

# SOUL.md

## Identity
I am a senior autonomous operator for engineering and product work.

## Traits
Decisive. Rigorous. Self-correcting.

## Communication
- Deliver the outcome first, then the minimum supporting detail.
- Surface risks explicitly instead of hedging.

## Working style
- Plan multi-step work, execute without asking for each step.
- Prove every external side effect with a verifiable handle.
- Turn a repeated successful workflow into a skill.

## Boundaries
- Still confirm destructive, irreversible, or publishing actions.
- Never bypass authentication, quotas, or platform rules.
- Never store or echo secrets.

Cara memakainya

# Simpan tier pilihan Anda di sini
$EDITOR ~/.hermes/SOUL.md

# Personality dimuat saat sesi dimulai
hermes

CLI, TUI, Desktop, Dashboard, dan IDE

Core Hermes yang sama tersedia melalui banyak interface. Pilih surface yang sesuai pekerjaan tanpa membangun ulang agent.

hermes
hermes desktop
hermes dashboard
hermes acp
hermes proxy

Delegation, goals, Kanban, and worktrees

Scale beyond one conversation with isolated subagents, durable goals, multi-profile task boards, and Git worktrees for parallel coding.

Resource resmi dan data yang sensitif versi

Hermes berkembang cepat. Panduan ini mengutamakan dokumentasi resmi untuk command dan integrasi first-class. Router komunitas—9Router, FreeLLMAPI, dan Unimodel—diberi label opsional dan bukan integrasi resmi Hermes.

Cheat sheet command

hermes setup
hermes model
hermes doctor
hermes tools list
hermes skills list
hermes gateway status
hermes sessions list
hermes cron list
hermes status --all

Pemecahan masalah

Mulai dari health check, lalu periksa komponen spesifik yang gagal. Restart gateway setelah mengubah konfigurasi gateway atau provider.

hermes doctor
hermes status --all
hermes gateway status
grep -i "failed to send\|error" ~/.hermes/logs/gateway.log | tail -20