hermes-mimo

v0.1.0

Published

15 days ago

CLI to switch Hermes Agent between MiMo-direct and a 9router model pool in one command.

0High
0Medium
0Low

arapzz

hermes hermes-agent mimo xiaomi-mimo 9router llm cli model-switch telegram-bot vps

🤖 Hermes Quickstart

Bot Telegram AI yang siap jalan dalam 5 menit di VPS Ubuntu kosong.

Cukup satu perintah, kamu dapat:

🤖 Bot Telegram yang bisa diajak chat AI
🌐 Dashboard web untuk monitor & atur model AI
⚡ Pilihan banyak model (MiMo, Claude, GPT, Gemini, dll)

📋 Yang kamu butuhkan

| | Apa | Cara dapat | |---|---|---| | 🖥️ | VPS Ubuntu (22 atau 24) | Contabo, Hetzner, DigitalOcean, dll. RAM minimal 1 GB | | 🔑 | Akses root ke VPS | Lewat SSH ssh root@ip-vps-mu | | 🤖 | Token Bot Telegram | Chat @BotFather → /newbot → ikutin instruksi | | 🆔 | ID Telegram kamu | Chat @userinfobot → dia kasih nomor | | 🔐 | API Key MiMo | Daftar di mimo.xiaomi.com → Token Plan → key dimulai tp-... |

🚀 Cara install (1 command)

Ganti xxx dengan token kamu, lalu paste ke terminal VPS:

curl -fsSL https://raw.githubusercontent.com/FlipZ3ro/hermes-quickstart/main/install.sh | \
  TELEGRAM_BOT_TOKEN=xxxxxxx \
  TELEGRAM_ALLOWED_USERS=xxxxxxx \
  MIMO_TOKEN=tp-xxxxxxx \
  bash

Contoh nyata:

curl -fsSL https://raw.githubusercontent.com/FlipZ3ro/hermes-quickstart/main/install.sh | \
  TELEGRAM_BOT_TOKEN=8123456789:AAFabcdefghijklmnop \
  TELEGRAM_ALLOWED_USERS=1402173933 \
  MIMO_TOKEN=tp-svtnl6tmk7im9zknw8kreoa2a8ezk81qbww87gh002qkw54c \
  bash

⏳ Tunggu 5-8 menit. Selesai akan keluar box hijau dengan password dashboard + URL.

✅ Habis install — cek bot

Buka Telegram → cari nama bot kamu (yang dari @BotFather)
Kirim /start atau ketik halo
Bot bakal balas dalam 2-4 detik

Kalau bot diem, cek log:

journalctl -u hermes-gateway -f

🗺️ Cara kerjanya (alur lengkap)

   [1] Install sekali                     [2] Add provider manual                 [3] Switch model via CLI
   ━━━━━━━━━━━━━━━━━━━━━                ━━━━━━━━━━━━━━━━━━━━━━━━━              ━━━━━━━━━━━━━━━━━━━━━━━━
        ┌────────────┐                    ┌────────────┐                          ┌────────────┐
        │  curl|bash │                    │  Dashboard │  ←─ paste API key ─┐    │   SSH ke   │
        │ (5-8 menit)│                    │  9router   │     (Claude / GPT  │    │    VPS     │
        └─────┬──────┘                    └─────┬──────┘      / MiMo / dll) │    └─────┬──────┘
              │                                  │                           │          │
              ▼                                  ▼                           │          ▼
        ┌────────────┐                    ┌────────────┐                     │   ┌────────────┐
        │ Bot, 9R,   │                    │  Provider  │                     │   │ Ketik mis. │
        │ Hermes UP  │                    │ ke-unlock  │                     │   │ hermes-9r..│
        └────────────┘                    └────────────┘                     │   │  /  -mimo  │
                                                                              │   └─────┬──────┘
                                                                              │         │
                                                                              │         ▼
                                                                              │   ┌────────────┐
                                                                              │   │ Bot otomatis│
                                                                              │   │ pakai model │
                                                                              │   │  baru      │
                                                                              │   └────────────┘
                                                                              │
                                              Sekali tambah, bisa dipilih ───┘

Step 1 — Install (sekali, di awal)

Jalankan one-liner curl di VPS kosong (lihat Cara install di atas). Setelah selesai, kamu udah punya:

Bot Telegram aktif (default pakai MiMo)
Dashboard 9router siap di http://IP-VPS/dashboard

Step 2 — Add provider (manual di dashboard, sesuai kebutuhan)

Tambah provider AI yang mau dipakai. Ini sekali per provider — habis itu modelnya tersedia selamanya.

Buka http://IP-VPS/dashboard → login pakai password (cek dengan grep INITIAL_PASSWORD /opt/9router/.env)
Sidebar → Providers → tombol + Add
Pilih provider yang mau (Xiaomi MiMo, Claude Code, OpenCode Free, Cerebras, dll)
Paste API key / login OAuth
Save → 9router otomatis validasi

Provider populer:

| Provider | Cara dapet | Catatan | |---|---|---| | Xiaomi MiMo (Token Plan) | mimo.xiaomi.com → Token Plan | Sudah ke-add otomatis dari install | | OpenCode Free | No signup, langsung add | Gratis Claude Sonnet, terbatas | | Cerebras | cerebras.ai → free key | Gratis, Llama 70B super cepat | | Groq | groq.com → API key | Gratis, throughput tinggi | | Google Gemini | aistudio.google.com | Gratis 60 req/menit | | Claude Code (OAuth) | Login akun Claude Pro | ⚠️ Risk ban — pakai akun cadangan |

Step 3 — Switch model (kapan aja, via CLI)

💡 Install via npm (di mesin mana pun yang udah ada Hermes Agent):
npm install -g hermes-mimo
Ini kasih 2 command global: hermes-mimo + hermes-9router. CLI auto-detect lokasi binary hermes dari PATH (atau fallback /root/.local/bin/hermes). Linux/macOS. Pada VPS hasil install.sh, kedua command sudah pre-installed dengan token ke-embed — jadi npm ini buat manual/reference use.

Habis provider ter-add, model-nya otomatis bisa dipakai. Ganti default model bot Telegram pakai 2 command ini:

# Pakai MiMo direct (tercepat, no 9router)
hermes-mimo

# Pakai 9router pool (semua provider yang udah di-add)
hermes-9router                                    # default: MiMo via 9router
MODEL=cc/claude-opus-4-6 hermes-9router           # ganti Claude Opus
MODEL=cc/claude-haiku-4-5-20251001 hermes-9router # ganti Claude Haiku
MODEL=oc/claude-sonnet-4.5 hermes-9router         # via OpenCode Free
MODEL=xmtp/mimo-v2.5-pro hermes-9router           # MiMo Pro

Bot otomatis pakai model baru tanpa restart manual.

💡 Tips: cek nama model lengkap di dashboard → Providers → klik provider → tab Available Models. Copy ID-nya (mis. cc/claude-opus-4-6).

Beda `hermes-mimo` vs `hermes-9router`

| | hermes-mimo | hermes-9router | |---|---|---| | Routing | Bot → MiMo langsung | Bot → 9router → provider apapun | | Kecepatan | ⚡ Tercepat (1 hop) | Sedikit lebih lambat (+20-50ms) | | Multi-provider | ❌ Cuma MiMo | ✅ Semua provider yang ter-add | | Auto fallback | ❌ | ✅ Kalau quota habis pindah otomatis | | Lihat usage di dashboard | ❌ Bypass | ✅ Tercatat semua | | Ganti model | Cuma region MiMo | Bebas semua provider |

Rule of thumb:

Pakai hermes-mimo kalau cuma butuh MiMo dan mau speed maksimal
Pakai hermes-9router kalau mau monitoring + multi-model + fallback (recommended)

🌐 Dashboard web

Buka di browser:

http://IP-VPS-KAMU/dashboard

Di dashboard kamu bisa:

➕ Tambah provider AI lain (Claude, OpenAI, Gemini, Cerebras, gratis)
📊 Lihat pemakaian token per provider
🔁 Setup fallback otomatis kalau quota habis
🔑 Bikin API key untuk app lain

❓ FAQ

Ganti ke model lebih cepat:

hermes-mimo                          # default mimo-v2.5
# atau via 9router pakai Haiku:
MODEL=cc/claude-haiku-4-5-20251001 hermes-9router

systemctl restart hermes-gateway
journalctl -u hermes-gateway -n 30

Kalau masih, paste output log ke Issues.

grep INITIAL_PASSWORD /opt/9router/.env

Itu password-nya.

Edit /root/.hermes/.env → tambah ID Telegram orangnya dipisah koma:

TELEGRAM_ALLOWED_USERS=1402173933,987654321,555000111

Lalu:

systemctl restart hermes-gateway

cd /opt/9router && systemctl stop 9router && \
  git pull && npm install && npm run build && \
  cp -r public .next/standalone/ && \
  cp -r .next/static .next/standalone/.next/ && \
  systemctl start 9router

pipx upgrade hermes-agent
systemctl restart hermes-gateway

# Stop & hapus dulu
systemctl stop 9router hermes-gateway 2>/dev/null
hermes gateway uninstall --system 2>/dev/null
pipx uninstall hermes-agent 2>/dev/null
rm -rf /opt/9router /var/lib/9router /root/.hermes
rm -f /etc/systemd/system/9router.service
rm -f /etc/nginx/sites-enabled/9router /etc/nginx/sites-available/9router
systemctl daemon-reload

# Lalu jalanin install.sh lagi
curl -fsSL https://raw.githubusercontent.com/FlipZ3ro/hermes-quickstart/main/install.sh | \
  TELEGRAM_BOT_TOKEN=... TELEGRAM_ALLOWED_USERS=... MIMO_TOKEN=... bash

Wajib: | Var | Contoh | |---|---| | TELEGRAM_BOT_TOKEN | 8123:AAF... | | TELEGRAM_ALLOWED_USERS | 1402173933 | | MIMO_TOKEN | tp-svtnl... |

Opsional: | Var | Default | Untuk | |---|---|---| | NINER_PASSWORD | random 16 karakter | Password dashboard 9router | | MIMO_REGION | sgp | sgp / cn / ams | | VPS_IP | auto-detect | IP publik buat embed di dashboard | | SKIP_UFW=1 | (firewall aktif) | Skip setup firewall |

Contoh dengan custom password:

curl -fsSL https://raw.githubusercontent.com/FlipZ3ro/hermes-quickstart/main/install.sh | \
  TELEGRAM_BOT_TOKEN=... \
  TELEGRAM_ALLOWED_USERS=... \
  MIMO_TOKEN=... \
  NINER_PASSWORD=MyPass123! \
  MIMO_REGION=cn \
  bash

🔒 Keamanan

✅ Password dashboard di-generate random secara default
✅ Bot Telegram cuma respond ke user yang ada di whitelist
✅ Semua secret disimpan di file .env mode 600 (cuma root yang baca)
✅ SSH key wajib (script tidak setup password SSH)
⚠️ Dashboard expose di port 80 tanpa HTTPS. Untuk produksi, pakai domain + Cloudflare/Let's Encrypt.

🧩 Apa yang ke-install

| | Komponen | Fungsi | |---|---|---| | 🚏 | 9router | Dashboard model router, OpenAI-compatible API | | 🤝 | Hermes Agent | AI agent dengan Telegram, tool use, memory | | 🌐 | nginx | Reverse proxy port 80 → 9router | | 🟢 | Node.js 22 | Runtime untuk 9router | | 🐍 | Python 3.12 + pipx | Runtime untuk Hermes | | 🛡️ | UFW firewall | Allow port 22 & 80 doang |

📂 File penting setelah install

| File | Isi | |---|---| | /opt/9router/.env | Password dashboard + secrets | | /root/.hermes/config.yaml | Setting model Hermes | | /root/.hermes/.env | Token Telegram + whitelist | | /usr/local/bin/hermes-mimo | CLI switch ke MiMo | | /usr/local/bin/hermes-9router | CLI switch ke 9router |

🛠️ Buat developer

Mau kontribusi atau modif?

git clone https://github.com/FlipZ3ro/hermes-quickstart.git
cd hermes-quickstart

# Edit install.sh
# Test syntax:
bash -n install.sh

# Test di VPS development
scp install.sh root@dev-vps:/tmp/
ssh root@dev-vps "TELEGRAM_BOT_TOKEN=xxx ... bash /tmp/install.sh"

PR welcome di GitHub.

📜 License

MIT — bebas dipakai, modif, distribute.

🙏 Credits

9router by @decolua
Hermes Agent by Nous Research
Xiaomi MiMo model family
Bootstrap by @FlipZ3ro