Cara Setting Hermes Agent Di Vps Menggunakan Docker

Menyiapkan Hermes Agent berfaedah menjalankannya sebagai container Docker di virtual private server (VPS), lampau menjalankan wizard pengaturan untuk memilih penyedia LLM, dan memastikan semuanya berfaedah lewat sesi chat singkat.

Hermes Agent adalah AI agent yang selalu aktif dan bisa terus meningkatkan kemampuannya sendiri. Tool ini belajar dari hubungan Anda seiring waktu untuk membangun skill yang bisa digunakan kembali. Setelah menyelesaikan suatu tugas, sistem ini memanfaatkan pengalaman tersebut untuk menangani tugas serupa dengan lebih baik pada kali berikutnya.

Anda bisa menginstal Hermes Agent langsung di server menggunakan installer curl bawaan, tapi Docker lebih cocok untuk deployment di VPS. Dengan demikian, agent ini bakal tetap tetap terpisah dari sistem host Anda, dan proses pembaruan selanjutnya cukup dilakukan dengan pull image baru.

Berikut langkah setting Hermes Agent di VPS menggunakan Docker:

1. Siapkan server. Gunakan VPS dengan minimal 2 core CPU dan RAM 8 GB. Pilih pengedaran Linux seperti Ubuntu.
2. Deploy container. Gunakan katalog aplikasi Hostinger untuk penginstalan sekali klik, alias pull image Docker secara manual jika Anda menggunakan penyedia VPS lain.
3. Konfigurasikan penyedia LLM. Jalankan wizard setup, pilih provider, masukkan API key, lampau pilih model.
4. Uji percakapan CLI. Pastikan agent merespons dengan betul dan bisa menggunakan tool sebelum Anda menambahkan perihal lain.
5. Tambahkan model, hubungkan gateway, dan konfigurasikan tool. Siapkan provider LLM tambahan, tambahkan Telegram, Discord, alias platform lain, lampau aktifkan kumpulan tool yang Anda perlukan.
6. Perkuat deployment Anda. Siapkan pemindaian perintah Tirith, konfigurasikan allowlist gateway, dan tambahkan patokan firewall untuk mengamankan pengaturan Anda.

1. Siapkan sistem VPS

Untuk menjalankan Hermes Agent, Anda memerlukan server dengan pengedaran Linux (disarankan menggunakan Ubuntu) serta akses root dan hubungan internet yang stabil.

Pilih paket VPS dengan setidaknya 2 core CPU dan RAM 8 GB. Konfigurasi ini bisa menangani isolasi Docker dan proses gateway dengan lancar. Container sendiri menggunakan sekitar 1 GB RAM, alias 2-4 GB jika Anda mengaktifkan otomatisasi browser.

Setelah membeli VPS, sambungkan ke VPS tersebut melalui SSH, lampau perbarui paket sistem Anda:

sudo apt pembaruan && sudo apt upgrade -y

Langkah ini membantu mencegah bentrok keterbatasan saat menginstal Docker dan komponen Hermes Agent.

Anda juga perlu mengamankan dan menyiapkan VPS. Buat user khusus, sesuaikan izin akses, dan aktifkan autentikasi kunci publik untuk akses yang lebih aman.

2. Deploy Hermes Agent dengan Docker

Docker mengemas Hermes Agent beserta semua dependensinya ke dalam satu container. Jadi, Anda tidak perlu melakukan penginstalan Python alias Node.js maupun mengatur environment variable secara manual.

Ada beberapa langkah untuk menjalankannya, tergantung pada setup yang Anda gunakan.

Kalau Anda belum punya VPS, opsi paling sigap dan mudah adalah menggunakan template Hermes Agent dari Hostinger. Pilih paket yang Anda inginkan, selesaikan pembayaran, lampau sistem bakal menginstal semuanya secara otomatis.

Selama proses penyiapan, Anda perlu membikin username dan password untuk mengakses terminal web Hermes Agent.

Setelah penginstalan selesai, Anda bakal masuk ke Docker Manager. Di sini, Hermes Agent bakal ditampilkan sebagai proyek Docker. Klik Buka di sebelahnya, lampau login menggunakan kredensial yang tadi sudah Anda buat.

Kalau Anda sudah mempunyai VPS Hostinger, Anda bisa deploy Hermes Agent dari hPanel. Buka VPS → OS & Panel → Sistem operasi → Ubah OS, cari Hermes Agent, lampau pilih untuk memulai penginstalan.

Setelah penginstalan selesai, buka Docker Manager → Proyek, lampau buka web terminal Hermes Agent dengan langkah yang sama.

Kalau Anda menggunakan penyedia VPS lain, lakukan penginstalan Docker terlebih dahulu. Setelah semuanya siap, buat direktori informasi untuk Hermes Agent lampau buka direktori tersebut:

mkdir -p ~/.hermes cd ~/.hermes

Lalu deploy container Hermes Agent:

docker run -it --rm \ -v ~/.hermes:/opt/data \ nousresearch/hermes-agent setup

Flag -v ~/.hermes:/opt/data bakal memasangkan direktori host ke path informasi container. Hermes Agent menyimpan file konfigurasi, API key, sesi, skill, dan memori di direktori ini.

3. Jalankan wizard penyiapan

Setelah Anda mengakses terminal web alias menjalankan container, wizard penyiapan Hermes Agent bakal otomatis terbuka. Sistem bakal menanyakan gimana Anda mau mengonfigurasi agent ini.

Tersedia dua metode:

• Setup cepat. Mencakup penyedia, model, dan pesan. Opsi ini paling mudah untuk sebagian besar pengguna.
• Pengaturan lengkap. Menambahkan pilihan backend terminal, pengaturan perilaku agen, toggle tool, dan konfigurasi persona.

Di sini, kita bakal menggunakan Quick setup. Anda bisa mengatur semua perihal lainnya nanti. Wizard ini bakal memandu Anda melalui langkah-langkah berikut:

1. Pilih penyedia LLM. Pilih dari OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama, alias endpoint kustom.

2. Masukkan API key. Tempelkan key untuk provider yang Anda pilih.
3. Pilih model. Pilih salah satu model yang tersedia untuk provider yang Anda pilih.

4. Hubungkan platform perpesanan. Pilih Telegram, Discord, Slack, WhatsApp, alias platform lain. Untuk sekarang, Anda bisa melewati bagian ini dan mencoba chat CLI terlebih dulu.

Hermes Agent menyimpan informasi sensitif, seperti API key, di ~/.hermes/.env, sementara informasi yang tidak sensitif disimpan di ~/.hermes/config.yaml.

4. Pastikan Hermes Agent sedang berjalan

Untuk memverifikasi bahwa Hermes Agent melangkah dengan betul setelah setup wizard selesai, mulai sesi CLI lampau periksa apakah agent bisa berkomunikasi dengan model yang Anda pilih:

hermes

Anda bakal memandang banner yang menampilkan model yang dipilih, tool yang tersedia, dan skill yang sudah dimuat.

Uji dengan prompt yang memicu tool, seperti “Apa yang ada di direktori saya saat ini?”. Langkah ini mengonfirmasi bahwa pemasok bisa merespons dan menjalankan perintah.

Untuk keluar dari sesi, ketik /exit. Gunakan hermes untuk memulai sesi baru, alias melanjutkan sesi terakhir dengan hermes –continue.

Kalau agent mengembalikan respons kosong alias mengalami error koneksi, penyebab yang paling umum adalah API key yang salah alias provider yang dikonfigurasi dengan keliru.

Jalankan kembali hermes setup untuk mengonfigurasi ulang provider dan API key Anda. Sebagai alternatif, gunakan perintah hermes doctor untuk memindai seluruh pengaturan dan mengidentifikasi masalahnya.

Setelah chat CLI berfungsi, Anda bisa menambahkan model lain, menghubungkan platform pesan, dan mengonfigurasi tool yang dibutuhkan workflow Anda.

Untuk menambahkan provider LLM baru selain yang sudah disiapkan, jalankan hermes model. Proses ini bakal memandu Anda memilih provider dan memasukkan API key, sama seperti setup wizard.

Setelah beberapa provider dikonfigurasi, Anda bisa beranjak di antaranya selama sesi berjalan dengan perintah /model di dalam chat.

Gateway pesan memungkinkan Anda berinteraksi dengan Hermes Agent melalui platform seperti Telegram, Discord, Slack, WhatsApp, Signal, alias email, bukan lewat CLI.

Gunakan hermes gateway setup untuk menghubungkan platform pilihan Anda, lampau ikuti petunjuk di layar.

Setelah penyiapan selesai, jalankan hermes gateway run untuk memulai bot. Kalau tidak, konfigurasinya tetap ada, tapi tidak aktif.

Hermes Agent juga dilengkapi tool bawaan seperti eksekusi terminal, pencarian web, akses ke sistem file, dan pembuatan gambar. Buka daftar tool dengan hermes tools, lampau aktifkan alias nonaktifkan setiap tool sesuai kebutuhan Anda.

Perlu diketahui bahwa beberapa tool, seperti penelusuran web dan pembuatan gambar, memerlukan API key yang aktif agar bisa berfungsi.

6. Terapkan prosedur keamanan Hermes Agent

Untuk melindungi konfigurasi Hermes Agent, Anda bisa menggunakan perlindungan bawaan milik agent tersebut sekaligus menetapkan patokan di level server yang membatasi akses dari luar.

Hermes Agent dilengkapi pemindai keamanan berjulukan Tirith. Tool ini memeriksa setiap perintah terminal sebelum dijalankan. Fitur ini aktif secara default dan bakal mencari akibat seperti prompt injection, pengambilan kredensial secara tidak sah, dan pola backdoor SSH.

Kalau Tirith menandai sebuah perintah, Anda bakal memandang ringkasan masalahnya. Anda bisa menyetujui alias menolaknya dengan /approve alias /deny. Untuk mengontrol langkah persetujuan berjalan, edit ~/.hermes/config.yaml:

approvals: mode: manual # manual | smart | off timeout: 60 # seconds to wait for user response (default: 60)

• manual. Meminta persetujuan sebelum setiap perintah yang berpotensi berisiko.
• smart. Menyetujui operasi berisiko rendah secara otomatis dan hanya meminta konfirmasi untuk operasi yang berbahaya.
• off. Menonaktifkan semua pemeriksaan persetujuan.

Gateway pesan juga perlu perlindungan. Di file config.yaml yang sama, tambahkan ID pengguna Anda ke daftar yang diizinkan untuk setiap platform agar hanya Anda yang bisa mengirim perintah ke bot.

Berikut contoh untuk Telegram:

gateway: telegram: allowed_user_ids: - 123456789

Ganti 123456789 dengan ID pengguna Telegram Anda yang sebenarnya. Anda bisa mendapatkannya dengan mengirim pesan ke @userinfobot di Telegram.

Untuk platform lain seperti Slack alias WhatsApp, tukar telegram dengan nama platform yang sesuai dan gunakan format ID pengguna yang betul untuk jasa tersebut.

Dari sisi jaringan, tutup port 8642 (server API) dan 9119 (dashboard) jika Anda hanya menggunakan Hermes Agent melalui platform chat. Gateway bakal membikin hubungan keluar, jadi tidak memerlukan trafik masuk:

sudo ufw deny 8642 sudo ufw deny 9119

Agar tetap menggunakan jenis terbaru, pull image terbaru lampau tukar container yang sedang berjalan:

docker pull nousresearch/hermes-agent:latest docker rm -f hermes docker run -d \ --name hermes \ --restart unless-stopped \ -v ~/.hermes:/opt/data \ nousresearch/hermes-agent gateway run

Semua informasi disimpan di volume ~/.hermes yang dipasang, jadi tidak ada yang lenyap saat proses update.

Untuk pengguna VPS Hostinger, Anda bisa mengupdate container langsung dari hPanel. Di Docker Manager, cari project Hermes Agent Anda, klik menu tiga titik, lampau pilih Perbarui.

Selain itu, amankan VPS Anda dengan menonaktifkan login SSH root, mengonfigurasi fail2ban untuk memblokir percobaan login berulang, dan menginstal pemindai malware untuk mendeteksi ancaman.

Kesalahan umum saat menyiapkan Hermes Agent

Masalah yang paling umum saat menyiapkan Hermes Agent meliputi menambahkan fitur sebelum memverifikasi chat CLI, tidak me-mount volume data, menggunakan kredensial API yang salah, melewati allowlist gateway, dan menjalankan perintah langsung di host.

• Menambahkan fitur sebelum memverifikasi chat CLI. Menghubungkan Telegram, mengaktifkan cron job, alias mengintegrasikan jasa pihak ketiga sebelum memastikan chat CLI berfaedah bakal membikin proses troubleshooting menjadi lebih sulit. Kalau ada yang bermasalah, Anda tidak bakal tahu letak masalahnya. Uji agent terlebih dulu di CLI, pastikan agent merespons dan bisa menggunakan tool, lampau tambahkan fitur lain.
• Tidak memasang volume data. Kalau Anda menjalankan container tanpa -v ~/.hermes:/opt/data, semua data, termasuk memori, skill, dan konfigurasi bakal tetap berada di dalam container. Saat container dimulai ulang, semuanya bakal hilang. Selalu sertakan flag volume saat menjalankan container secara manual.
• Menggunakan kredensial API yang salah alias sudah kedaluwarsa. Kalau API key salah alias kedaluwarsa, agent tidak bisa berkomunikasi dengan model. Periksa kembali key di dashboard provider Anda alias buat yang baru. Kemudian, jalankan hermes setup lagi untuk mengupdatenya.
• Melewati allowlist gateway. Kalau Anda menyiapkan bot pesan tanpa menambahkan allowed_user_ids di config.yaml, siapa pun yang menemukan username bot Anda bisa berinteraksi dengannya. Tambahkan ID pengguna Anda ke daftar izin agar hanya Anda yang bisa mengaksesnya.
• Tetap menggunakan backend terminal default di VPS. Secara default, agent menjalankan perintah terminal langsung di server Anda. Di VPS, kondisi ini bisa memengaruhi seluruh sistem Anda. Ganti ke container sandbox denga konfigurasi hermes terminal.backend docker agar perintah melangkah di lingkungan yang terisolasi.

Cara mengelola Hermes Agent setelah setup

Untuk mengelola Hermes Agent setelah setup, beberapa langkah yang perlu Anda lakukan adalah menjaga container dan gateway tetap dalam kondisi baik, menjadwalkan tugas berulang dengan cron, serta menggunakan dashboard web untuk mengelola penginstalan Anda.

• Memantau log dan kesehatan gateway. Log container adalah tempat pertama yang perlu diperiksa saat ada sesuatu yang terasa tidak beres. Jalankan docker logs hermes untuk meninjau output terbaru, alias docker logs -f hermes untuk mengikuti log secara real-time. Untuk gateway, gunakan hermes gateway status untuk memandang platform mana yang terhubung, dan hermes gateway restart untuk menyambungkan kembali platform yang terputus.
• Menjadwalkan tugas berulang. Scheduler cron bawaan menjalankan tugas seperti ringkasan harian, backup setiap malam, dan laporan mingguan. Tool ini mengirimkan hasil ke platform pesan yang sudah Anda hubungkan. Atur agenda dengan hermes cron, lampau agent ini bakal menangani eksekusinya secara otomatis.
• Mengakses dashboard web. Dashboard web adalah antarmuka berbasis browser untuk mengelola penginstalan Hermes Agent Anda. Alih-alih mengedit file YAML alias menjalankan perintah lewat CLI, Anda bisa mengatur konfigurasi, mengelola API key, memantau sesi, dan menjadwalkan cron job lewat antarmuka visual. Jalankan dengan perintah di bawah ini, lampau buka http://your-server-ip:9119 di browser:

docker run -d \ --name hermes-dashboard \ --restart unless-stopped \ -v ~/.hermes:/opt/data \ -p 9119:9119 \ nousresearch/hermes-agent dashboard

Apa saja contoh penggunaan Hermes Agent?

Dengan Hermes Agent yang melangkah di VPS, Anda mempunyai asisten AI yang selalu aktif dan bisa diakses kapan saja melalui channel komunikasi pilihan Anda.

Penggunaannya bakal berjuntai pada kebutuhan Anda; apakah Anda seorang developer, admin sistem, alias hanya memerlukan asisten pribadi yang melangkah di server milik sendiri.

Untuk tugas development, Anda bisa meminta pemasok untuk clone repositori, menyiapkan environment staging, dan menjalankan pengujian, semuanya lewat pesan Telegram saat Anda sedang tidak menggunakan komputer.

Admin sistem bisa menyiapkan cron job dengan bahasa alami. Sebagai contoh, Anda bisa menjadwalkan laporan penggunaan disk mingguan agar dikirim ke Slack setiap Senin pagi, alias meminta pemasok memantau sebuah jasa dan mengirim peringatan saat jasa tersebut berakhir berfungsi.

Untuk penggunaan pribadi, Anda bisa meminta pemasok mengirim ringkasan pagi berisi almanak Anda, buletin utama, dan notifikasi GitHub sebelum hari Anda dimulai. Selamat mencoba dan semoga berhasil!

Semua konten tutorial di website ini telah melalui peninjauan menyeluruh sesuai standar dan komitmen editorial Hostinger.