Install Hermes Cukup Dengan 1 Perintah

Beberapa waktu lalu aku sempat belajar masang Hermes Agent, AI agent buatan Nous Research yang bisa diajak chat lewat Telegram. Waktu itu aku masangnya pakai role Ansible yang aku bikin sendiri, sebagai bagian dari latihan integrasi Hermes sama Zimbra. Role-nya bisa dilihat di repo zahwaptr/ansible-hermes-agent-zhwaptr.

Ansible itu enak buat ngatur banyak server sekaligus. Tapi buat orang yang cuma mau nyobain Hermes di satu server, harus nyiapin Ansible dulu. Tapi dengan script ansible ini juga sudah membantu rekan kerja ku yang dari non IT itu bisa ter install hermes nya.

Dari situ aku kepikiran, gimana kalau semua langkahnya dibungkus jadi satu perintah aja? Tinggal copy, paste, jawab beberapa pertanyaan, terus agent-nya jalan.

Jadilah get-hermes, installer Hermes Agent + Telegram yang cukup dijalanin pakai satu baris ini:

curl -fsSL https://get.zahwajuliana.web.id/install-hermes.sh | bash

Di tulisan ini aku mau cerita isinya apa aja, cara pakainya, dan apa yang terjadi di balik layar waktu perintah itu dijalanin.

Installer Ini Ngapain Aja?

Begitu dijalanin, installer-nya bakal ngerjain tujuh langkah ini secara berurutan:

  1. Cek sistem. Mastiin server-nya Linux dengan distro yang didukung, yaitu Ubuntu/Debian atau Rocky/RHEL, dan punya systemd.
  2. Cek sistem. Mastiin server-nya Linux dengan distro yang didukung, yaitu Ubuntu/Debian atau Rocky/RHEL, dan punya systemd.
  3. Pasang Hermes Agent. Lewat installer resmi dari Nous Research.
  4. Nyambungin Telegram dan AI. Nanya token bot, user ID Telegram, provider AI (DeepSeek atau OpenRouter), dan API key-nya.
  5. Ngasih identitas ke agent. Nanya nama, peran, organisasi, tugas utama, dan zona waktu agent.
  6. Nyimpen pengaturan. Token dan API key disimpan di ~/.hermes/.env yang dikunci, terus identitas agent ditulis ke SOUL.md.
  7. Nyalain agent 24 jam. Hermes dipasang sebagai systemd service, jadi tetap jalan walau terminal ditutup dan nyala lagi sendiri kalau server di-restart.

Bagian yang paling aku suka itu langkah kelima. Jawaban kamu soal nama, peran, dan tugas agent bakal dirangkai jadi file SOUL.md, semacam “kepribadian” yang dibaca agent tiap mulai ngobrol. Jadi begitu disapa, agent-nya langsung ngenalin diri pakai Bahasa Indonesia, manggil kamu pakai nama Telegram kamu, dan nyebutin tugas-tugasnya.

Di SOUL.md juga udah ada aturan dasarnya. Misalnya agent harus minta konfirmasi dulu sebelum hapus data atau restart layanan, nggak boleh nampilin isi .env atau API key, dan nggak boleh nurutin perintah dari orang yang nggak terdaftar.

Cara Pakainya Seperti Ini

Siapin tiga hal ini dulu

  1. Token bot Telegram. Buka Telegram, cari @BotFather, kirim /newbot, terus ikutin instruksinya.
  2. User ID Telegram. Cari @userinfobot, kirim pesan apa aja, terus salin angka di baris “Id”.
  3. API key AI. Dari platform.deepseek.com atau openrouter.ai. Biaya pemakaian AI-nya nanti ditagih ke akun pemilik API key ini.

Server-nya cukup Ubuntu/Debian atau Rocky/RHEL, dengan akses root atau sudo.

Jalanin perintahnya

Login ke server, terus jalanin:

curl -fsSL https://get.zahwajuliana.web.id/install-hermes.sh | bash

Installer-nya bakal nanya satu per satu. Ada beberapa hal kecil yang perlu kamu tahu:

  • Teks di dalam [kurung siku] itu jawaban bawaan. Kalau udah cocok, tinggal tekan Enter.
    Nama agent [Hermes]:
    Peran agent [asisten AI pribadi]:
    Provider AI, ketik nama saja (deepseek/openrouter) [deepseek]:
    Zona waktu (nama kota atau WIB/WITA/WIT) [Asia/Jakarta]:
  • Waktu nempel token atau API key, layarnya sengaja nggak nampilin apa-apa. Itu normal, bukan error.
  • Zona waktu bisa diisi pakai nama kota atau singkatan, misalnya WIB, Bandung, atau Bali. Installer bakal nyariin zona waktu resminya sendiri.
  • Tanda ✔ artinya langkah itu berhasil. Kalau mau batal, tekan Ctrl+C kapan aja.

Total waktunya sekitar 3 sampai 10 menit, tergantung kecepatan internet server.

Coba ngobrol sama agent-nya

Kalau udah muncul tulisan “Selesai!”, buka bot kamu di Telegram terus:

  1. Kirim /new biar percakapannya mulai dari awal dan identitas terbaru kepakai.
  2. Kirim “Halo”. Agent-nya bakal nyapa kamu, ngenalin diri, dan nyebutin tugas-tugasnya.

Kalau dalam semenit belum dibalas, cek pesan error-nya pakai:

sudo journalctl -u hermes-agent -n 50

Penyebab yang paling sering biasanya token bot atau API key yang salah.

Mau tanpa ditanya-tanya?

Semua jawaban juga bisa dikasih langsung lewat variabel, cocok kalau mau dipakai buat otomatisasi:

curl -fsSL https://get.zahwajuliana.web.id/install-hermes.sh | \
  TELEGRAM_BOT_TOKEN="123:ABC..." TELEGRAM_ALLOWED_USERS="6xxxxxxx5" \
  HERMES_PROVIDER=deepseek DEEPSEEK_API_KEY="sk-..." \
  AGENT_NAME="Lawawa" AGENT_ROLE="asisten AI tim IT" bash

Kenapa bisa satu perintah?

Perintah curl -fsSL ... | bash itu sebenarnya dua langkah yang disambung. curl ngunduh isi script dari internet, terus tanda | (pipe) langsung nyerahin isinya ke bash buat dijalanin. Jadi nggak perlu download file dulu, kasih izin eksekusi, baru dijalanin.

Script-nya sendiri aku taruh di repo GitHub zahwaptr/get-hermes, terus di-host pakai GitHub Pages dengan domain get.zahwajuliana.web.id. Jadi tiap aku update script di repo, versi yang diunduh orang juga ikut ke-update.

Kalau penasaran isi lengkapnya, script-nya bisa dibaca dulu sebelum dijalanin:

curl -fsSL https://get.zahwajuliana.web.id/install-hermes.sh | less

Ini kebiasaan yang bagus juga sebenarnya. Sebelum jalanin script apa pun lewat curl | bash, baca dulu isinya biar tahu apa yang bakal dikerjain di server kamu.

Bikin script yang jalan itu baru setengahnya. Setengahnya lagi bikin script yang gampang dipakai orang lain. Pesan error yang jelas, jawaban bawaan, dan keterangan di tiap langkah ternyata makan waktu yang nggak kalah banyak dari logikanya.

Kepikiran skenario gagal dari awal. Gimana kalau internet putus, token salah ketik, atau installer dijalanin dua kali? Hal-hal kecil kayak gini yang bikin script terasa “aman” buat dipakai.

Sekarang buat nyiapin Hermes Agent + Telegram di server baru, aku cukup jalanin satu perintah dan jawab beberapa pertanyaan. Agent-nya langsung punya nama, tahu tugasnya, dan jalan 24 jam.

Kalau kamu mau nyobain, perintahnya ini:

curl -fsSL https://get.zahwajuliana.web.id/install-hermes.sh | bash

Repo lengkapnya ada di GitHub: github.com/zahwaptr/get-hermes. Kalau kamu lebih suka pakai Ansible, misalnya buat masang di banyak server sekaligus, role Ansible-nya juga ada di github.com/zahwaptr/ansible-hermes-agent-zhwaptr. Kalau nemu bug atau punya ide fitur, boleh banget kasih tahu lewat kolom komentar.

Okey, segitu dulu… See you next blog ya guys!

Leave a Reply

Your email address will not be published. Required fields are marked *