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 — isi sebuah domain Dashboard (mis. my-hermes). Opsional, siapkan penyedia LLM Anda sekarang dengan mengatur LLM_API_KEY, LLM_BASE_URL, dan LLM_MODEL (penyedia apa pun yang kompatibel dengan OpenAI); kosongkan untuk mengonfigurasi model nanti.
2. Buka Dashboard — kunjungi domain Anda (otomatis ter-bind ke Dashboard). Anda bisa menambahkan domain kustom nanti di tab Networking.
3. Masuk — nama pengguna admin, kata sandi = PASSWORD layanan Anda (ditampilkan pada instruksi layanan). Langsung chat di browser — tanpa Telegram.

Ingin penyedia lain atau Telegram? Atur variabel penyedia kompatibel OpenAI Anda (LLM_API_KEY / LLM_BASE_URL / LLM_MODEL) dan tambahkan variabel lingkungan pesan setelah deploy — lihat Model & Penyedia dan Platform Pesan di bawah.

Port & Domain

Layanan ini menyediakan dua port HTTP:

Port	Id	Tujuan	Domain
9119	web	Dashboard web (aktif secara bawaan, dilindungi login)	Domain utama layanan — buka dan masuk
5000	api	Server API kompatibel OpenAI	Bind domain hanya jika perlu akses API eksternal

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

Menggunakan Dashboard web

Dashboard aktif secara bawaan dan dilindungi login. Buka domain layanan Anda (port web) lalu masuk:

• Nama pengguna: admin
• Kata sandi: nilai PASSWORD layanan Anda (ditampilkan pada instruksi layanan)

Untuk menonaktifkan, atur HERMES_DASHBOARD=false di tab Variables. Untuk mengubah kredensial, atur HERMES_DASHBOARD_BASIC_AUTH_USERNAME / HERMES_DASHBOARD_BASIC_AUTH_PASSWORD.

Catatan keamanan: Basic auth cocok untuk backend di balik jaringan tepercaya; untuk eksposur publik yang lebih kuat gunakan OAuth (HERMES_DASHBOARD_OAUTH_CLIENT_ID) atau OIDC mandiri (HERMES_DASHBOARD_OIDC_*) — lihat referensi variabel lingkungan.

Menggunakan OpenAI-compatible API

Bind domain ke port api (5000) di tab Networking, lalu kirim permintaan dengan kunci API yang dibuat otomatis:

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

Platform Pesan

Pesan bersifat opsional — secara bawaan Anda berinteraksi melalui Dashboard web (tanpa perlu platform apa pun). Untuk menghubungkan Telegram, tambahkan TELEGRAM_BOT_TOKEN (dari @BotFather) dan TELEGRAM_ALLOWED_USERS (ID pengguna Telegram Anda dari @userinfobot) di tab Variables, lalu restart. Hermes mendukung 14+ platform (Discord, Slack, WhatsApp, Signal, Matrix, Email, WeChat, WeCom, Feishu, DingTalk, QQ Bot, Mattermost, BlueBubbles/iMessage, SMS, Home Assistant, webhook umum) — masing-masing diaktifkan dengan mengatur variabel lingkungannya setelah deployment.

Lihat panduan resmi Messaging Gateway untuk instruksi pengaturan setiap platform.

Model & Penyedia

Template ini berjalan dengan penyedia apa pun yang kompatibel dengan OpenAI yang Anda bawa. Atur berikut ini di tab Variables lalu restart:

• Kunci API — atur LLM_API_KEY ke kunci penyedia Anda.
• Endpoint — atur LLM_BASE_URL ke base URL kompatibel OpenAI milik penyedia, mis. https://api.openai.com/v1. Jika Anda mengatur kunci tetapi mengosongkan base URL, agen akan error hingga Anda mengisinya — ini disengaja agar kesalahan konfigurasi terlihat.
• Model — atur LLM_MODEL ke id model, mis. gpt-4o-mini.
• Penyedia lain (Minimax, Kimi, GLM/Zhipu, Gemini, NVIDIA, xAI, …) — atur LLM_API_KEY / LLM_BASE_URL / LLM_MODEL untuk penyedia tersebut, atau tambahkan variabel lingkungan kunci API penyedia itu sendiri (mis. KIMI_API_KEY, MINIMAX_API_KEY) dan pilih model dengan hermes model di tab Exec. Lihat panduan Configuration dan referensi variabel lingkungan.

Saat LLM_API_KEY diatur, LLM_API_KEY / LLM_BASE_URL / LLM_MODEL diterapkan ke blok model pada /opt/data/config.yaml setiap kali start (provider custom). Kosongkan LLM_API_KEY untuk mengelola config.yaml secara manual.

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 ~1.3 GB (unduhan). Deployment pertama biasanya selesai diunduh dalam waktu kurang dari satu menit; deployment berikutnya menggunakan kembali image dari cache.
• 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.