Install Hermes Agent dari Nol

Panduan lengkap — dari VPS $1.50 sampai connect Telegram. Semua OS. Gak perlu skill coding.

Apa itu Hermes Agent?

Hermes Agent adalah autonomous AI agent dari Nous Research. Bukan chatbot wrapper — dia bisa jalanin terminal, buka browser, baca/tulis file, self-improve, dan connect ke 20+ platform messaging.

Prasyarat

Satu-satunya prerequisite wajib: Git. Installer auto-detect + install sisanya (Python, Node.js, ripgrep, ffmpeg).

Daftar VPS Budget (Update Juni 2026)

Pilih lokasi Singapore/Hongkong untuk latency rendah ke Indonesia.

📱 Termux (Android) — Gratis, Tanpa VPS

Yang Didukung

✅ Hermes CLI — core agent | ✅ Cron — scheduled task | ✅ Telegram gateway (best-effort) | ✅ MCP/ACP/Honcho | ✅ File + Code Ops
❌ Docker backend | ❌ Voice transcription (faster-whisper) | ❌ Browser automation

Install — Option 1: One-line

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

Install — Option 2: Manual Step-by-step

# Step 1: Update + install packages
pkg update && pkg upgrade -y
pkg install python git build-essential

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

# Step 3: Create virtual environment
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m venv venv
source venv/bin/activate
python -m pip install --upgrade pip setuptools wheel

# Step 4: Install tested Termux bundle
python -m pip install -e '.[termux]' -c constraints-termux.txt

# Step 5: Permanent PATH
ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

# Step 6: Verify
hermes version
hermes doctor

Troubleshooting Termux

Install — Linux / macOS / WSL2

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

Setelah install, reload shell:

source ~/.bashrc   # atau: source ~/.zshrc

Verifikasi: hermes --version

Apa yang Installer Lakukan?

• Deteksi OS + install dependencies (uv, Python 3.11, Node.js 22, ripgrep, ffmpeg)
• Clone repo ke ~/.hermes/hermes-agent/
• Setup virtual environment Python + install semua package
• Bikin global command hermes di PATH
• Prompt setup provider AI (bisa di-skip)

Install — Windows

PowerShell

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

Alternative: WSL2 (Recommended)

wsl --install -d Ubuntu
wsl
sudo apt update && sudo apt install python3 python3-pip -y
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

macOS / Windows Desktop

Download Hermes Desktop installer — ada GUI.

Setup Provider AI

hermes model    # Interactive wizard

⚠ Minimum context: 64K tokens. Model di bawah 64K akan di-reject.

Chat Pertama

hermes          # CLI klasik
hermes --tui    # Modern TUI (recommended!)

Test prompt pertama kamu:

Check my current directory, list files, and tell me the 5 largest ones.

Kalo agent balas + bisa pake tool → setup berhasil. ✅

Slash Commands (dalam chat)

Ketik / buat liat semua: /help, /tools, /model, /save, /reset

Resume sesi terakhir: hermes --continue atau hermes -c

API Key Gratisan & Router Murah

Gak mau bayar provider? Ini caranya:

9Router — AI Model Router Gratis

Route traffic ke 40+ provider lewat 1 endpoint. Gratis, open-source.

Self-host di VPS sendiri atau localhost. Pooling model gratis + berbayar jadi 1 API endpoint.

# Install cepat
curl -fsSL https://9router.com/install.sh | bash
docker run -d -p 20128:80 --name 9router your-image

# Atau dari source
git clone https://github.com/nousresearch/9router.git
cd 9router && docker compose up -d

42+ Provider Supported

OpenAI, Anthropic, Google, Groq, SambaNova, DeepSeek, OpenRouter, Ollama, Together AI, Mistral, Cohere, Fireworks, Perplexity, xAI, Replicate, HuggingFace, Cerebras, dan banyak lagi.

Connect Telegram

Step 1: Bikin Bot di @BotFather

Chat @BotFather → /newbot → isi nama & username (akhiran bot) → simpan bot token (format: 123456:ABCdef...)

Step 2: Cari User ID

Chat @userinfobot — simpan numeric user ID.

Step 3: Setup di Hermes

hermes gateway setup  # Interactive wizard

Atau manual via ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Step 4: Start Gateway

hermes gateway    # Bot online dalam hitungan detik

Platform Lainnya

20+ platform via command yang sama: hermes gateway setup — Discord, Slack, WhatsApp, Signal, Email, dan lainnya.

SOUL.md — Personality Agent

File ~/.hermes/SOUL.md mengubah tone, style, dan aturan agent. Dari "chatbot penurut" jadi "autonomous operator".

# Edit SOUL.md
nano ~/.hermes/SOUL.md
# Restart Hermes — personality langsung aktif

4 Tier SOUL.md

Cheat Sheet

Troubleshooting

FAQ