🔐

Premium Access

Masukkan password untuk akses
Hermes Migration Guide

Step-by-step · Copy-paste je · No coding needed

Migrate Hermes Agent
dari VPS ke Local.

Chat dengan agent kau dulu, suruh dia pack semua data. Pastu isi info kau sekali — semua commands bawah auto-fill. Copy-paste je.

Setup Time
~55 min
Difficulty
Easy
Phases
9
VPS Cost After
RM0 /bln
Phase 0 · Mula Di Sini

Suruh agent kau pack semua data.

Sebelum buat apa-apa, kena generate migration file dulu. Caranya — chat je dengan agent kau dalam Telegram atau Discord.

💬 Hantar prompt ni ke agent kau
Copy prompt ni, paste dalam Telegram atau Discord bot kau, tekan send.
📱 Telegram / Discord — copy & send
Pack semua data kau untuk migration, buat file tar.gz dalam /tmp/
✅ Contoh reply agent
Siap boss — 38MB kat /tmp/agentname_migrate_v3.tar.gz

Dah pack semua: .env, config, google token, profiles, skills, sessions, cron state.
⚠️
Nota penting
Perhatikan nama file exact dalam reply agent kau — contoh agentname_migrate_v3.tar.gz. Kau akan copy nama tu masuk field kat Phase 1 bawah.
Phase 1 · Setup Info

Isi info kau sekali, auto-fill semua.

Isi 5 fields ni. Semua commands bawah akan guna info kau secara automatic — tak perlu edit satu-satu.

⚙️ Your Setup Info
Maklumat ni hanya dalam browser kau — tak dihantar ke mana-mana.
IP droplet DigitalOcean kau
Nama user machine baru — contoh: john
Copy dari reply agent kau kat Phase 0 ☝️
Nama agent kau — untuk plist & folder labels
Dari @BotFather — saved locally je, tak dihantar mana-mana
0 / 4 fields diisi
✅ Semua commands dah di-update dengan info kau! Boleh proceed.
Phase 2 · Before You Start

Apa kau perlu sediakan.

Pastikan semua benda ni ada sebelum start.

🖥️
Mac Mini / Windows PC
Machine yang akan jadi host baru. Kena sentiasa ON.
☁️
VPS Access (DigitalOcean)
SSH access ke droplet lama. Kena ada IP dan password.
🤖
Migration Pack
Dah generate kat Phase 0? Dah ada filename? ☝️
🌐
Internet Connection
Stable. Avoid campus WiFi — boleh block SSH port 22.
⚠️
Jangan guna campus WiFi
Campus WiFi selalu block port 22 (SSH). Guna hotspot atau WiFi rumah.
Phase 3 · 10 min

Download data dari VPS.

SSH ke VPS, extract migration pack dari Docker container, pastu download ke machine kau.

3.1SSH ke droplet
terminal
ssh root@YOUR_VPS_IP
3.2Extract pack dari container
dalam VPS
docker cp hermes:/tmp/YOUR_TARBALL /tmp/YOUR_TARBALL
3.3Verify file size
dalam VPS
ls -lh /tmp/YOUR_TARBALL
Expected output
  • Size dalam ~38MB
  • Filename match dengan reply agent tadi
3.4Download ke local machine
terminal — keluar VPS dulu
exit
terminal — Mac
scp root@YOUR_VPS_IP:/tmp/YOUR_TARBALL ~/Downloads/
command prompt — Windows
scp root@YOUR_VPS_IP:/tmp/YOUR_TARBALL C:\Users\YOUR_USERNAME\Downloads\
Phase 4 · 5 min

Pindah file ke machine baru.

Kalau download kat PC/laptop lain — pindahkan ke machine yang nak jadi host.

ℹ️
Skip kalau same machine
Kalau dah download terus kat machine host — skip ke Phase 5.
  • ✓ AirDrop (Mac ke Mac)
  • ✓ Google Drive — upload dari PC, download kat machine baru
  • ✓ USB drive
  • ✓ Telegram Saved Messages (38MB okay je)
⚠️
Jangan guna WhatsApp
WhatsApp compress dan boleh corrupt tarball. Guna Telegram, Google Drive, atau USB.
Phase 5 · 10 min

Install Hermes Agent.

Install Hermes binary dulu sebelum restore data.

5.1Download install script

Download dulu, jangan terus run — baca isi dia dulu.

terminal — Mac
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh -o install.sh
powershell — Windows
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh" -OutFile install.sh
5.2Run installer — pilih Full Setup
terminal
bash install.sh
  • 1Guna arrow key ↓ → pilih "Full Setup" bukan Quick Setup
  • 2Pilih "Local" untuk run environment
  • 3Enable Telegram dan WhatsApp — tekan SPACE untuk select
  • 4Tekan Enter skip soalan API keys — kita restore dari tarball
5.3Reload shell & verify
terminal — Mac
source ~/.zprofile && hermes --version
terminal — Windows
hermes --version
Expected output
  • Hermes Agent v0.x.x
  • Python: 3.11.x
  • Tiada "command not found"
Phase 6 · 5 min

Restore semua data agent.

Extract tarball ke dalam folder Hermes — restore semua skills, sessions, memories, API keys, dan personality.

6.1Extract tarball
terminal — Mac
tar -xzf ~/Downloads/YOUR_TARBALL -C ~/.hermes/
terminal — Windows WSL
tar -xzf /mnt/c/Users/YOUR_USERNAME/Downloads/YOUR_TARBALL -C ~/.hermes/
6.2Verify data intact
terminal
ls -la ~/.hermes/ | grep -E ".env|SOUL|config"
Semua ni patut ada
  • .env — API keys
  • SOUL.md — personality file
  • config.yaml — Hermes settings
  • google_token.json — Google OAuth
Phase 7 · 10 min

Setup Telegram gateway.

Tambah Telegram credentials ke dalam .env supaya agent boleh connect ke bot kau.

7.1Dapat Bot Token & User ID
  • 1Pergi Telegram → cari @BotFather → taip /mybots
  • 2Pilih bot kau → API Token → copy
  • 3Cari @userinfobot → send sebarang message → copy ID nombor
7.2Edit .env
terminal
nano ~/.hermes/.env

Cari TELEGRAM_BOT_TOKEN dan TELEGRAM_ALLOWED_USERS. Buang # dan isi nilai:

.env
# Buang # dan isi nilai sebenar: TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN TELEGRAM_ALLOWED_USERS=YOUR_TELEGRAM_USER_ID
💡
Save dalam nano
Ctrl+X → Y → Enter
7.3Test agent respond
terminal
hermes gateway run

Hantar "hi" ke Telegram bot. Patut reply. Lepas confirm, tekan Ctrl+C — setup auto-start next phase.

Phase 8 · 5 min

Setup auto-restart.

Agent auto-start bila machine restart — tak perlu manual run.

8.1Dapat path Hermes
terminal — Mac
which hermes

Output contoh: /Users/YOUR_USERNAME/.local/bin/hermes

8.2Create launchd plist
terminal — Mac
nano ~/Library/LaunchAgents/com.YOUR_AGENT.hermes.plist
plist config — paste ni
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key><string>com.YOUR_AGENT.hermes</string> <key>ProgramArguments</key> <array> <string>/Users/YOUR_USERNAME/.local/bin/hermes</string> <string>gateway</string> <string>run</string> </array> <key>RunAtLoad</key><true/> <key>KeepAlive</key><true/> <key>StandardOutPath</key> <string>/Users/YOUR_USERNAME/.hermes/logs/hermes.log</string> <key>StandardErrorPath</key> <string>/Users/YOUR_USERNAME/.hermes/logs/hermes-error.log</string> </dict></plist>
8.3Activate & verify
terminal — Mac
launchctl load ~/Library/LaunchAgents/com.YOUR_AGENT.hermes.plist launchctl list | grep hermes
Expected output
  • Ada PID (nombor) di kolom pertama
  • Exit code = 0 (kolom tengah)
  • com.YOUR_AGENT.hermes di kolom ketiga
ℹ️
Windows — Task Scheduler
Buka Task Scheduler → Create Basic Task → Trigger: "At log on" → Action: start program → masukkan path hermes + argument gateway run.
Phase 9 · 5 min

Verify semua okay.

Final checklist sebelum declare migration complete.

  • ✓ Hermes running — launchctl list | grep hermes → PID & exit code 0
  • ✓ Telegram bot reply — hantar "hi", patut reply
  • ✓ Memory intact — bot ingat conversation lama
  • ✓ Skills ada — tanya bot buat sesuatu
  • ✓ Auto-restart working — kill PID, tunggu 10s, PID baru muncul
  • ✓ Google Sheets accessible
🎉
Migration Complete!
Agent kau dah hidup kat local machine. VPS boleh decommission untuk save cost.
💡
Decommission VPS
Bila dah confirm agent okay selama beberapa hari, pergi DigitalOcean dashboard → destroy droplet untuk stop billing.