Ikut step ikut urutan. Setiap command ada butang biru — tekan untuk salin, paste dalam terminal, tekan Enter.
1
Install WSL2
Buka PowerShell sebagai Admin → jalankan command ni
Windows
📌 Cara buka PowerShell sebagai Admin:
1. Tekan butang Windows pada keyboard
2. Taip: PowerShell
3. Klik kanan pada "Windows PowerShell" → pilih "Run as administrator"
4. Klik Yes bila popup muncul
Salin command di bawah → Paste dalam PowerShell → Tekan Enter
PowerShell (Admin)
wsl --install
⏳Tunggu sampai siap → Restart komputer → Lepas restart, Ubuntu akan buka sendiri dan minta kau set username + password (boleh guna apa-apa).
2
Install Hermes
Buka Ubuntu → jalankan command ni → tunggu siap
Windows
📌 Cara buka Ubuntu:
Tekan butang Windows → taip Ubuntu → klik untuk buka.
⏳Tunggu 3–10 minit. Jangan tutup window. Nanti nampak tanda ✓ hijau bila dah siap.
Command 2 — Lepas install siap, run ni (salin & paste & Enter)
Ubuntu Terminal
source ~/.bashrc
3
Dapatkan API Key & Pilih Model AI
Daftar OpenRouter → dapat API key → run command ni
Semua OS
📌 Buat akaun OpenRouter dulu (percuma):
1. Pergi ke openrouter.ai → klik Sign Up
2. Lepas login → klik nama profil atas kanan → pilih API Keys
3. Klik Create Key → namakan apa-apa (contoh: "hermes") → klik Create
4. Copy key yang keluar — nampak macam: sk-or-v1-abc123...
Salin command di bawah → Paste dalam Ubuntu Terminal → Tekan Enter
Ubuntu Terminal
hermes model
✅ Apa yang akan berlaku:
Menu akan muncul → guna arrow keys ↑↓ pilih OpenRouter → tekan Enter → masuk API key kau → Enter → pilih model → Enter → siap.
4
Mula Chat dengan Hermes
Run command ni → Hermes akan start → taip soalan kau
Semua OS
Salin command di bawah → Paste → Tekan Enter
Ubuntu Terminal
hermes
⚠️Jangan tutup Ubuntu terminal selagi guna Hermes. Minimize je kalau nak. Kalau tutup, Hermes mati.
★
Bonus: Connect ke Telegram (optional)
Supaya boleh chat dengan Hermes terus dari Telegram
Semua OS
A — Buat Bot Telegram & Dapatkan Token
1. Buka Telegram → search @BotFather → buka chat
2. Taip /newbot → tekan Enter
3. BotFather tanya nama bot → taip apa-apa contoh: My Hermes → Enter
4. BotFather tanya username → taip apa-apa yang end dengan "bot" contoh: myhermesbot → Enter
5. BotFather akan bagi token — nampak macam ni: 7234819502:AAF8xKp...
6. Copy token tu, save dalam Notepad
B — Dapatkan User ID kau
1. Dalam Telegram → search @userinfobot → buka chat
2. Tekan Start atau taip /start
3. Bot akan reply dengan maklumat kau — cari baris Id:
4. Nombor tu (contoh: 987654321) adalah User ID kau → Copy & save
C — Setup Gateway dalam Terminal
Command 1 — Setup (salin & paste & Enter)
Ubuntu Terminal
hermes gateway setup
Menu akan tanya:
• Pilih platform → pilih Telegram → Enter
• Masuk bot token → paste token dari BotFather → Enter
• Masuk user ID → paste nombor dari @userinfobot → Enter
• Done ✓
Command 2 — Start Gateway (salin & paste & Enter)
Ubuntu Terminal
hermes gateway
🎉
Hermes dah hidup!
Agent AI pertama kau dah running. Selagi Ubuntu terminal buka, Hermes available.
1
Buka Terminal
Terminal adalah tempat kau paste semua command dalam guide ni
macOS
📌 Cara buka Terminal:
1. Tekan ⌘ Command + Space pada keyboard
2. Taip: Terminal
3. Tekan Enter
4. Window gelap atau putih akan muncul — itu Terminal. Kau dah ready.
ℹ️Jangan tutup Terminal sepanjang proses setup. Semua command dalam guide ni kau paste dalam satu window Terminal yang sama.
2
Install Hermes
Satu command je — installer buat semua kerja secara automatik
⏳Tunggu 3–10 minit. Kalau Mac tanya password — taip password Mac kau dan tekan Enter (kau takkan nampak apa yang taip — tu normal). Jangan tutup terminal.
Command 2 — Lepas install siap, run ni (salin & paste & Enter)
Terminal
source ~/.zshrc
3
Dapatkan API Key & Pilih Model AI
Daftar OpenRouter → dapat API key → run command ni
Semua OS
📌 Buat akaun OpenRouter dulu (percuma):
1. Pergi ke openrouter.ai → klik Sign Up
2. Lepas login → klik nama profil atas kanan → pilih API Keys
3. Klik Create Key → namakan apa-apa → klik Create
4. Copy key yang keluar — nampak macam: sk-or-v1-abc123...
Salin command di bawah → Paste dalam Terminal → Tekan Enter
Terminal
hermes model
Menu akan muncul → guna arrow keys ↑↓ pilih OpenRouter → Enter → masuk API key → Enter → pilih model → Enter → siap.
4
Mula Chat dengan Hermes
Run command ni → Hermes akan start → taip soalan kau
Semua OS
Salin command di bawah → Paste → Tekan Enter
Terminal
hermes
⚠️Jangan tutup Terminal selagi guna Hermes. Minimize je kalau nak. Kalau tutup, Hermes mati.
★
Bonus: Connect ke Telegram (optional)
Supaya boleh chat dengan Hermes terus dari Telegram
Semua OS
A — Buat Bot Telegram & Dapatkan Token
1. Buka Telegram → search @BotFather → buka chat
2. Taip /newbot → tekan Enter
3. Taip nama bot → Enter → taip username (mesti end dengan "bot") → Enter
4. BotFather bagi token — copy & save dalam Notes
B — Dapatkan User ID kau
1. Dalam Telegram → search @userinfobot → buka chat
2. Tekan Start atau taip /start
3. Cari baris Id: dalam reply → nombor tu adalah User ID kau → copy & save
C — Setup Gateway dalam Terminal
Command 1 — Setup
Terminal
hermes gateway setup
Pilih Telegram → masuk bot token → masuk User ID → done ✓
Command 2 — Start Gateway
Terminal
hermes gateway
🎉
Hermes dah hidup!
Agent AI pertama kau dah running. Selagi Terminal buka, Hermes available.
🩺 Ada masalah? Cuba ini dulu
Diagnose masalah automatik (salin & paste & Enter)
Terminal
hermes doctor
Masalah
Cara Fix
hermes: command not found
Run source ~/.bashrc (WSL) atau source ~/.zshrc (macOS) → cuba lagi
API key not set
Run hermes model semula → masukkan API key OpenRouter
Hermes tak balas
Run hermes model semula — API key mungkin salah
WSL2 tak boleh install
Pastikan Windows 10 v2004+ atau Windows 11. Update Windows dulu.
Bot Telegram tak respond
Pastikan hermes gateway masih running dalam terminal. Jangan close terminal tu.
Bengkel Agentic AI · Panduan Setup Hermes Local · Reruai Digital
