Hermes Agent

Hermes Agent adalah agen AI otonom yang dikembangkan oleh Nous Research. Dilengkapi dengan memori persisten, 40+ alat bawaan, penjadwalan tugas, dan dukungan pesan multi-platform.

Mulai Cepat

1. Deploy template ini — masukkan kunci API OpenRouter (wajib) dan opsional token bot Telegram.
2. Bind domain — buka tab Networking dan bind domain ke port yang Anda butuhkan (lihat «Port & Domain» di bawah).
3. Mulai gunakan — melalui Dashboard web, Telegram, atau OpenAI-compatible API.

Port & Domain

Layanan ini menyediakan dua port HTTP independen. Bind domain hanya ke port yang benar-benar Anda gunakan:

Port	Tujuan	Kapan perlu bind domain
5000	Server API kompatibel OpenAI	Hanya jika perlu akses API eksternal (curl, SDK, dll.)
9119	Dashboard web (perlu HERMES_DASHBOARD=true)	Hanya jika ingin antarmuka browser

Platform pesan (Telegram, Discord, Slack, dll.) menggunakan koneksi keluar — tidak memerlukan URL publik atau port yang dibuka.

Menggunakan OpenAI-compatible API

Bind domain ke port 5000, lalu kirim permintaan dengan kunci API yang dibuat otomatis:

curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "default", "messages": [{"role": "user", "content": "Hello!"}]}'

Menggunakan Dashboard web

1. Atur HERMES_DASHBOARD=true di tab Variables dan restart layanan.
2. Bind domain ke port 9119 di tab Networking.
3. Akses Dashboard melalui domain tersebut.

Catatan keamanan: Dashboard akan dapat diakses secara publik dari internet. Jangan aktifkan tanpa memahami risikonya — siapa pun yang mengetahui URL dapat mengakses dan mengontrol agen Anda. Autentikasi OAuth dapat dikonfigurasi melalui HERMES_DASHBOARD_OAUTH_CLIENT_ID (lihat referensi variabel lingkungan).

Platform Pesan

Telegram dikonfigurasi saat deployment sebagai contoh. Anda dapat mengaktifkan salah satu dari 14+ platform yang didukung (Discord, Slack, WhatsApp, Signal, Matrix, Email, WeChat, WeCom, Feishu, DingTalk, QQ Bot, Mattermost, BlueBubbles/iMessage, SMS, Home Assistant, webhook umum) dengan mengatur variabel lingkungan yang sesuai setelah deployment.

Lihat panduan resmi Messaging Gateway untuk instruksi pengaturan setiap platform.

Menggunakan Zeabur AI Hub (alternatif OpenRouter)

Sebagai pengganti kunci OpenRouter, Anda dapat menggunakan Zeabur AI Hub — agregator yang kompatibel dengan OpenAI. Setelah deployment:

1. Masukkan kunci AI Hub Anda ke OPENROUTER_API_KEY (gunakan variabel yang sama).
2. Edit /opt/data/config.yaml melalui tab "Berkas" Zeabur:
   • model.base_url: "https://sfo1.aihub.zeabur.ai/v1" (atau hnd1 untuk Tokyo)
   • model.default: "claude-sonnet-4-5" (atau model AI Hub lainnya)
3. Restart layanan.

Catatan: variabel lingkungan OPENROUTER_BASE_URL tidak menimpa config.yaml; Anda harus mengedit file tersebut.

Konfigurasi

• Penyedia LLM, alat, dan pengaturan lainnya — lihat panduan resmi Configuration dan referensi variabel lingkungan.
• Edit file konfigurasi di /opt/data/ melalui tab "Berkas" Zeabur:
  • config.yaml — pemilihan model, backend terminal, pengaturan platform
  • SOUL.md — kepribadian agen dan system prompt
  • .env — semua variabel lingkungan
• Setelah mengedit, restart layanan untuk menerapkan perubahan.

Akses CLI

Anda dapat menggunakan CLI Hermes langsung melalui tab Exec Zeabur (atau zeabur service exec):

Perintah	Deskripsi
hermes	Chat interaktif (REPL)
hermes --tui	UI terminal modern
hermes -z "prompt"	Kueri sekali jalan (untuk skrip)
hermes status	Tampilkan status semua komponen
hermes model	Ganti model / penyedia
hermes config	Lihat atau edit konfigurasi
hermes sessions list	Daftar riwayat percakapan
hermes -c	Lanjutkan percakapan terakhir
hermes cron	Kelola tugas terjadwal
hermes skills	Jelajahi dan instal skill

Jalankan hermes --help untuk daftar perintah lengkap.

Catatan

• Image Docker berukuran ~4.5 GB (termasuk Playwright + Chromium untuk otomatisasi browser). Deployment pertama mungkin memerlukan beberapa menit untuk mengunduh image.
• Boot pertama memerlukan 30-60 detik untuk menginisialisasi file konfigurasi dan menyinkronkan skill.
• Penggunaan alat browser dapat menyebabkan penggunaan memori yang tinggi — jika mengalami error OOM (kehabisan memori), pertimbangkan untuk meningkatkan ke instance yang lebih besar (disarankan 4 vCPU / 8 GB RAM).

Lisensi

Hermes Agent dilisensikan di bawah Lisensi MIT oleh Nous Research.