Kembali ke Semua Tulisan

Setup Hermes di STB HG680P

2 menit baca
project learning

Pendahuluan

Hermes Agent (v0.15.1) adalah framework AI agent yang powerful untuk menghubungkan model AI dengan berbagai platform (Telegram, Discord, dll). Di STB HG680P dengan Armbian, setup ini cocok buat automation, monitoring, dan personal AI assistant di perangkat low-resource. Artikel ini mencatat setup yang sedang berjalan di perangkat saya.

Prasyarat

  • STB HG680P dengan Armbian (kernel 6.12.85-ophub atau sejenis)
  • Akses root
  • Storage cukup (disarankan pakai SSD eksternal /mnt/ssd untuk HERMES_HOME)
  • Python 3.11 (sudah ada di Armbian)
  • Koneksi internet

Instalasi Hermes Agent

Hermes Agent diinstall di lokasi tetap:

/usr/local/lib/hermes-agent

Venv Python ada di dalam direktori tersebut. CLI bisa dipanggil via:

/usr/local/bin/hermes

Atau langsung:

hermes --version

Membuat dan Mengelola Profile

Profile yang dipakai bernama uril.

hermes --profile uril [command]

Lokasi profile:

  • /root/.hermes/profiles/uril
  • Mirror: /mnt/ssd/hermes/.hermes/profiles/uril

File penting di profile:

  • config.yaml
  • auth.json
  • cron/jobs.json (untuk scheduled task)

Menjalankan Gateway sebagai Systemd Service

Buat file service:

sudo nano /etc/systemd/system/hermes-gateway-uril.service

Isi file:

[Unit]
Description=Hermes Agent Gateway - Messaging Platform Integration
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=0

[Service]
Type=simple
User=root
Group=root
ExecStart=/usr/local/lib/hermes-agent/venv/bin/python -m hermes_cli.main --profile uril gateway run --replace
WorkingDirectory=/usr/local/lib/hermes-agent
Environment="HOME=/root"
Environment="USER=root"
Environment="LOGNAME=root"
Environment="PATH=/usr/local/lib/hermes-agent/venv/bin:/usr/local/lib/hermes-agent/node_modules/.bin:/mnt/ssd/hermes/.hermes/node/bin:/root/.local/bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
Environment="VIRTUAL_ENV=/usr/local/lib/hermes-agent/venv"
Environment="HERMES_HOME=/root/.hermes/profiles/uril"
Restart=always
RestartSec=5
RestartMaxDelaySec=300
RestartSteps=5
RestartForceExitStatus=75
KillMode=mixed
KillSignal=SIGTERM
ExecReload=/bin/kill -USR1 $MAINPID
TimeoutStopSec=210
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Aktifkan service:

sudo systemctl daemon-reload
sudo systemctl enable --now hermes-gateway-uril
sudo systemctl status hermes-gateway-uril

Cek log:

journalctl -u hermes-gateway-uril -f

Konfigurasi Dasar

File config utama:

/root/.hermes/profiles/uril/config.yaml

Contoh minimal yang sedang dipakai:

model:
  default: grok-build-0.1
  provider: xai
auxiliary:
  title_generation:
    provider: xai

Catatan Khusus STB HG680P (Low Resource)

  • Gunakan SSD eksternal untuk /mnt/ssd/hermes supaya tidak membebani storage internal STB.
  • Service berjalan sebagai root (sesuai kebutuhan akses sistem).
  • Untuk cron job (contoh: monitoring), data disimpan di cron/jobs.json di dalam profile.
  • Restart service setelah perubahan config: sudo systemctl restart hermes-gateway-uril

Verifikasi Setup

  1. Cek versi Hermes: hermes --version
  2. Cek service aktif
  3. Test interaksi via Telegram (sesuai channel yang terdaftar di profile)
  4. Cek HERMES_HOME yang dipakai service (bisa beda dengan CLI default)

Kesimpulan

Dengan setup di atas, Hermes Agent bisa berjalan stabil di STB HG680P sebagai background service dengan auto-restart. Cocok untuk monitoring, automation, dan berbagai task berbasis AI.