Panduan Cepat Hermes Agent: Dari Instalasi hingga Langkah Pertama

Mengapa Hermes layak untuk diperhatikan

Jika Anda pernah menginstal alat AI baru, melihat binary-nya masuk ke PATH, namun tetap berakhir dengan sesuatu yang secara teknis ada tetapi praktis tidak berguna, Anda sudah memahami masalah yang dipecahkan oleh quickstart Hermes Agent ini. Instalasi yang selesai hanya membuktikan bahwa file telah disalin. Itu tidak membuktikan bahwa agent dapat memeriksa repo, berbicara ke model nyata, menggunakan alat dengan aman, atau membuka kembali pekerjaan tersebut nanti.

Itulah mengapa Hermes layak untuk diperhatikan. Ketika berfungsi dengan baik, ia berhenti terasa seperti “ChatGPT di terminal” dan mulai berperilaku seperti agent operasional. Ia dapat memeriksa file, menggunakan alat terminal, tetap berada di dalam workspace, dan melanjutkan sesi ke depan alih-alih bertindak seolah setiap prompt dimulai dari nol lagi.

Itu menjadikannya pilihan yang tepat untuk developer, self-hoster, dan pengguna yang mengutamakan terminal yang menginginkan bantuan dengan tugas nyata: merangkum codebase, memeriksa repo di mesin pribadi, atau berjalan di VPS kecil dari AlexHost, AvaHost, atau penyedia lainnya tanpa langsung masuk ke tumpukan otomasi yang lebih besar. Di akhir panduan ini, Anda akan memiliki Hermes yang terinstal, terkonfigurasi, diuji pada tugas pertama yang aman, dan berhasil dilanjutkan.

Apa itu Hermes — dan apa yang sebenarnya akan dibantu oleh panduan ini

Sebelum Anda menjalankan perintah apa pun, pisahkan tiga istilah ini. Sebagian besar kebingungan pertama kali muncul dari menggabungkannya menjadi satu gagasan samar tentang “AI.”

Tabel berikut memberi Anda model mental yang berfungsi untuk tutorial ini:

Artikel ini hanya menargetkan satu kondisi keberhasilan: satu sesi Hermes yang aman dan berfungsi yang dapat Anda mulai, uji, dan lanjutkan. Ini bukan panduan deployment produksi. Ini bukan tur fitur lengkap. Ini adalah jalur paling singkat yang dapat diandalkan menuju “Hermes berfungsi di mesin saya, dan saya dapat membuktikannya.”

📝 Catatan: Menginstal Hermes tidak sama dengan mengonfigurasi Hermes. Binary dapat hadir dan tetap tidak dapat digunakan sampai Anda menjalankan hermes model dan menghubungkannya ke provider dan model.

Anda mungkin memperhatikan bahwa dokumen resmi juga menawarkan hermes setup. Itu valid, tetapi panduan ini sengaja memisahkan instalasi dari hermes model sehingga Anda dapat melihat dengan tepat di mana sebagian besar keberhasilan atau kegagalan pertama kali terjadi. Kami juga mengutamakan classic-CLI untuk kemudahan reproduksi, meskipun hermes –tui tersedia dan menggunakan sesi yang sama. Di luar cakupan quickstart ini: pengaturan gateway, cron, MCP, jaringan model lokal, perutean multi-provider, dan penguatan produksi.

Aturan keamanan sebelum Anda memberi Hermes akses shell

Sebelum Anda menguji agent apa pun dengan akses terminal, tentukan di mana ia diizinkan untuk salah. Untuk artikel ini, itu berarti mesin non-produksi, VM, repo sekali pakai, atau setidaknya workspace berisiko rendah di mana perintah yang tidak disengaja tidak akan merusak hari Anda.

⚠️ Peringatan: Pertahankan persetujuan dalam mode aman default untuk seluruh quickstart ini, dan jangan gunakan –yolo. Hermes meminta konfirmasi sebelum perintah berisiko; itu adalah fitur keamanan, bukan gesekan yang tidak perlu.

Gunakan daftar periksa cepat ini sebelum Anda melanjutkan:

• Mulai di mesin atau workspace berisiko rendah.
• Pertahankan prompt persetujuan yang diaktifkan.
• Hindari repo produksi pribadi untuk pengujian pertama.
• Harapkan tugas pembuktian tetap bersifat read-only.
• Perlakukan backend terminal Docker dan SSH sebagai langkah penguatan selanjutnya, bukan persyaratan hari pertama.

Tugas pembuktian nyata pertama dalam panduan ini tetap berada di dalam ~/.hermes/hermes-agent, yang membuat demo tetap relevan dengan Hermes sekaligus menghindari proyek sensitif. Setelah alur CLI dasar stabil, Anda dapat beralih ke isolasi yang lebih kuat dengan Docker atau backend jarak jauh. Untuk jam pertama, aman dan dapat diperiksa lebih baik daripada ambisius.

Sebelum Anda menginstal: prasyarat, jalur yang didukung, dan satu masalah WSL2

Untuk pengguna umum, cerita yang didukung sederhana: Linux, macOS, dan WSL2 adalah jalur yang perlu diperhatikan terlebih dahulu. Windows native ada, tetapi masih dalam beta awal, jadi jika Anda menggunakan Windows, rekomendasi praktisnya masih WSL2.

Di Ubuntu 24.04 atau WSL2, mulailah dengan memastikan git dan curl tersedia:

Jika baris kedua mengembalikan string distro Anda beserta output versi yang berfungsi untuk kedua alat tersebut, prasyarat dasar Anda sudah terpenuhi. Di macOS, pemeriksaan yang setara biasanya hanya mengonfirmasi git –version dan curl –version sebelum menggunakan installer Hermes yang sama.

📝 Catatan: Windows native masih merupakan jalur beta awal, jadi lebih baik gunakan WSL2 jika Anda menggunakan Windows.
💡 Tips: Di WSL2, simpan Hermes dan repo kerja Anda di bawah ~ alih-alih /mnt/c untuk menghindari operasi Git yang lebih lambat dan perilaku izin file yang aneh.

Kabar baiknya adalah Hermes tidak mengharuskan Anda untuk merakit tumpukan dependensi besar secara manual terlebih dahulu. Installer git resmi menangani uv, Python 3.11, Node.js 22, ripgrep, dan ffmpeg untuk Anda. Yang harus Anda siapkan sebelum wizard pengaturan dimulai adalah akun provider, atau setidaknya rencana yang telah diuji untuk endpoint kustom. Juga, pilih model dengan konteks setidaknya 64K: jendela konteks yang lebih kecil cenderung berantakan begitu agent mulai membawa konteks file, output alat, dan instruksi multi-langkah secara bersamaan.

Instal Hermes Agent dengan jalur satu baris resmi

Dengan prasyarat yang sudah terpenuhi, jalankan installer resmi persis seperti yang didokumentasikan:

Ini sekarang lebih dari sekadar langkah instalasi biasa. Hermes mendeteksi platform, mempersiapkan dependensi yang dibutuhkan, dan kemudian langsung melanjutkan ke alur pengaturan pertama kali. Dalam contoh di atas, installer mendeteksi Linux, memeriksa uv, menginstal Python 3.11 jika diperlukan, mempersiapkan Node.js 22 untuk alat browser, dan membangun lingkungan perintah Hermes.

Jika instalasi Anda dilakukan sebagai root, Anda mungkin melihat jalur seperti /usr/local/bin/hermes, /usr/local/lib/hermes-agent, dan /root/.hermes/. Pada instalasi pengguna biasa, harapkan struktur yang sama di bawah direktori home Anda sendiri.

Detail penting adalah bahwa installer satu baris sekarang langsung masuk ke wizard pengaturan. Dengan kata lain, instalasi dan konfigurasi pertama kali adalah satu alur yang berkelanjutan. Jangan anggap akhir instalasi paket sebagai garis finish, karena Hermes sebenarnya tidak berguna sampai wizard pengaturan ini selesai.

Keputusan pertama adalah provider inferensi. Dalam pengujian ini, OpenRouter dipilih, yang merupakan pilihan pertama yang praktis karena memberikan akses ke katalog model yang luas melalui satu akun provider. Jika Anda sudah menggunakan provider yang didukung yang berbeda, pilih itu sebagai gantinya.

Setelah provider dipilih, Hermes meminta API key yang sesuai. Dalam contoh ini, itu berarti OPENROUTER_API_KEY. Tempelkan key tersebut, tekan Enter, dan Hermes menyimpannya untuk penggunaan di masa mendatang.

Jika Anda melewati langkah ini, Hermes dapat menyelesaikan instalasi, tetapi belum siap untuk sesi agent nyata. Anda perlu kembali dan mengonfigurasi provider nanti.

Setelah key disimpan, wizard beralih ke pemilihan model. Dalam pengujian ini, model yang dipilih adalah deepseek/deepseek-v4-pro. Itu adalah contoh konkret yang valid, tetapi bukan satu-satunya jalur Anda: wizard juga memungkinkan Anda memasukkan nama model kustom atau melewati dan mempertahankan model saat ini jika Anda menjalankan ulang pengaturan pada instalasi yang sudah ada.

Untuk pertama kali, aturan praktisnya sederhana: pilih satu model yang sudah Anda ketahui dapat Anda akses, dan pastikan memiliki konteks yang cukup untuk pekerjaan agent nyata. Hermes jauh lebih andal dengan model yang menawarkan jendela konteks setidaknya 64K. Jendela konteks yang lebih kecil mungkin terlihat baik-baik saja dalam pengujian kecil, lalu rusak begitu output alat, konteks file, dan instruksi multi-langkah mulai menumpuk.

Jika Anda ingin mengubah pilihan ini nanti, hermes model masih merupakan cara tercepat untuk menjalankan ulang pemilihan provider dan model tanpa menginstal ulang apa pun.

Selanjutnya, Hermes menanyakan seberapa banyak pengaturan yang lebih luas yang ingin Anda lakukan sekarang. Untuk quickstart ini, opsi yang direkomendasikan adalah yang benar: quick setup.

Itu membuat artikel tetap fokus pada jalur utama: provider, model, dan pilihan minimal di sekitarnya yang diperlukan untuk membuat Hermes dapat digunakan.

Layar berikutnya menanyakan tentang backend terminal. Untuk pertama kali, pertahankan backend lokal saat ini sehingga Hermes berjalan langsung di mesin ini. Docker, SSH, Modal, dan backend lainnya berguna nanti, tetapi menambah kompleksitas sebelum Anda bahkan mengonfirmasi bahwa alur kerja CLI dasar berfungsi.

Hermes kemudian menawarkan pengaturan platform pesan. Untuk quickstart ini, lewati saja. Itu membuat panduan tetap berpusat pada alur agent CLI inti, dan Anda dapat menambahkan Telegram, Discord, atau jalur pesan lainnya nanti dengan hermes setup gateway.

Setelah wizard selesai, Hermes menampilkan di mana ia menyimpan file-file penting.

Pembagian utama yang perlu diingat sederhana: config.yaml menyimpan pengaturan non-rahasia, .env menyimpan API key dan rahasia lainnya, dan direktori data menyimpan sesi, log, dan status runtime terkait. Dalam screenshot ini jalurnya berada di bawah /root/.hermes/ karena instalasi dilakukan sebagai root. Pada instalasi pengguna biasa, baca jalur tersebut sebagai ~/.hermes/.

Hermes kemudian mencetak ringkasan siap-pakai yang singkat, termasuk perintah yang paling mungkin Anda gunakan pertama kali.

Pada titik ini, Hermes sudah terinstal dan terkonfigurasi. Hal berikutnya yang perlu dilakukan adalah memverifikasi bahwa lingkungan dalam kondisi baik sebelum melanjutkan ke tugas nyata pertama:

hermes doctor harus mengonfirmasi hal-hal dasar: tidak ada advisory keamanan aktif, lingkungan Python yang berfungsi, dan paket yang diperlukan tersedia. Itulah sinyal keberhasilan bersih yang Anda inginkan sebelum melanjutkan.

Jika hermes belum terlihat di shell baru, muat ulang shell Anda dan verifikasi jalur perintah sebelum melanjutkan. Di Bash itu biasanya berarti source ~/.bashrc; di Zsh, source ~/.zshrc. Jika diperlukan, konfirmasi launcher dengan command -v hermes.

Dengan Doctor yang lulus, instalasi tidak hanya selesai — Hermes sekarang benar-benar siap digunakan.

Jalankan tugas agent pertama yang aman

Dengan Hermes yang sekarang sudah terinstal, terkonfigurasi, dan diperiksa oleh hermes doctor, Anda siap untuk demonstrasi nyata pertama. Workspace pertama yang paling aman dan bernilai tinggi adalah direktori home Hermes itu sendiri. Dalam pengujian ini, instalasi dilakukan sebagai root, sehingga direktori tersebut adalah /root/.hermes. Pada instalasi pengguna biasa, tempat yang sama adalah ~/.hermes.

Pindah ke direktori tersebut, konfirmasi posisi Anda, lalu jalankan Hermes:

Ini adalah workspace pertama yang baik karena sudah ada, langsung terkait dengan alat yang baru saja Anda instal, dan berisiko rendah dibandingkan dengan menempatkan agent di repo pribadi atau produksi. Layar startup juga merupakan pemeriksaan kewarasan yang berguna dengan sendirinya: ini menunjukkan Hermes diluncurkan dengan benar, model aktif di footer, dan fakta bahwa agent sudah dapat melihat alat dan skill yang tersedia.

Jika Anda lebih menyukai antarmuka yang lebih baru, hermes –tui masih tersedia, tetapi panduan ini mengutamakan classic-CLI karena lebih mudah direproduksi langkah demi langkah dan kedua antarmuka berbagi sesi yang sama.

Ketika Hermes terbuka, berikan prompt sederhana dan read-only yang memintanya untuk memeriksa workspace saat ini dan mengidentifikasi entrypoint. Dalam contoh ini, prompt secara eksplisit menargetkan /root/.hermes karena instalasi dilakukan sebagai root. Pada instalasi pengguna biasa, arahkan ke direktori ~/.hermes Anda sendiri.

Gunakan prompt berikut:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

Inilah jenis tugas pertama yang Anda inginkan: aman, dapat diamati, dan mudah diverifikasi. Dalam screenshot di atas, Hermes tidak hanya menebak. Ia mulai membaca file konkret seperti config.yaml, SOUL.md, dan .install_method, mencari file terkait Hermes, dan memeriksa jalur launcher yang terinstal. Aktivitas alat yang terlihat itulah bukti nyata bahwa Hermes berperilaku seperti agent alih-alih kotak chat satu kali.

Hasil yang sehat harus kembali dengan ringkasan konkret yang terkait dengan workspace dan entrypoint yang dapat diperiksa. Dalam pengujian ini, Hermes mengidentifikasi wrapper perintah yang terinstal di /usr/local/bin/hermes, menjelaskan bahwa itu mengarah ke entrypoint CLI Python, dan merangkum lingkungan Hermes di sekitarnya dalam lima poin.

Itulah sinyal keberhasilan yang perlu dicari. Jawabannya spesifik, didasarkan pada file yang benar-benar diperiksa Hermes, dan mudah diperiksa terhadap apa yang sudah dapat Anda lihat di disk. Jangan anggap hasilnya sebagai keajaiban — bandingkan ringkasan dengan file yang terlihat dan tata letak direktori. Untuk demo pertama, aman dan dapat diverifikasi jauh lebih baik daripada mengesankan.

Lanjutkan sesi dan konfirmasi pengaturan benar-benar berfungsi

Quickstart tidak selesai ketika Hermes menjawab sekali. Ini selesai ketika Anda mengonfirmasi bahwa sesi dapat dilanjutkan.

Gunakan perintah resume di bawah ini; -c adalah bentuk singkat untuk tindakan yang sama:

Hasil yang diharapkan adalah Hermes membuka kembali sesi terbaru atau memberi Anda rekap yang jelas milik tugas yang baru saja Anda jalankan. Itu penting karena membuktikan Hermes tidak bertindak seperti chat satu kali yang sekali pakai. Ia mempertahankan sesi kerja yang tahan lama yang dapat Anda kembali.

Gunakan daftar periksa keberhasilan ringkas ini sebelum Anda melanjutkan:

• Hermes terinstal dan diverifikasi
• Provider terkonfigurasi
• Balasan pertama bersih
• Tugas repo pertama selesai
• Sesi berhasil dilanjutkan

Jika resume tidak berfungsi, pertama pastikan Anda menggunakan profil yang sama, lalu periksa sesi yang tersedia dengan hermes sessions list. Setelah hermes –continue berfungsi, Anda memiliki baseline penuh yang dimaksudkan untuk ditetapkan oleh tutorial Hermes Agent ini.

Apa yang perlu dicoba selanjutnya setelah alur kerja dasar berfungsi

Setelah chat dasar stabil, tambahkan hanya satu lapisan baru pada satu waktu.

💡 Tips: Tahan keinginan untuk mengaktifkan setiap fitur lanjutan segera. Stabilkan satu alur kerja yang bersih terlebih dahulu, lalu perluas secara bertahap.

Berikut adalah menu singkat langkah selanjutnya yang masuk akal:

• Coba hermes –tui jika Anda menginginkan antarmuka terminal yang lebih baru di atas model sesi yang sama.
• Jalankan hermes setup nanti jika Anda menginginkan wizard pengaturan yang lebih luas setelah memahami dasar-dasarnya secara manual.
• Jelajahi hermes gateway setup jika tujuan berikutnya adalah integrasi platform pesan.
• Tinjau hermes tools dan hermes skills ketika Anda menginginkan perluasan kemampuan yang terkontrol.
• Beralih ke backend terminal Docker atau SSH jika agent akan mulai menyentuh sistem yang lebih berisiko tinggi.
• Gunakan dokumen resmi untuk provider kustom dan endpoint model lokal setelah jalur hosted sudah berfungsi.

Jika Anda menginginkan ide tindak lanjut untuk penggunaan nyata, berikut beberapa yang bagus untuk diteliti selanjutnya: catatan orientasi codebase, penyusunan changelog, perencanaan refactor yang aman, penjelasan file konfigurasi, ringkasan tinjauan pull request, daftar periksa pemeliharaan VPS, penyusunan runbook deployment, prompt triase log, dan penemuan celah dokumentasi.

Untuk jalur yang lebih dalam, tautkan ke luar alih-alih memperluas quickstart ini menjadi artikel kedua: quickstart, dokumen instalasi, panduan CLI, dan panduan keamanan adalah pemberhentian berikutnya yang tepat.

Anda sekarang memiliki quickstart Hermes yang aman dan berfungsi

Tonggak penting bukan bahwa Hermes terinstal. Tonggak penting adalah bahwa Hermes menjadi berguna. Anda sekarang memiliki baseline yang terverifikasi: binary ada, provider terkonfigurasi, balasan pertama berfungsi, tugas aman pertama selesai, dan sesi dilanjutkan setelahnya.

Itulah tempat yang tepat untuk berhenti dan merayakan keberhasilan. Pertahankan persetujuan aktif, perluas satu lapisan pada satu waktu, dan beralih ke isolasi yang lebih kuat ketika agent mulai melakukan pekerjaan yang lebih berisiko tinggi. Jika Anda akhirnya menjalankan Hermes di workstation pribadi, mesin lab, atau VPS dari AlexHost, AvaHost, atau di mana pun, aturannya tetap sama: dapatkan kepercayaan dalam langkah-langkah kecil.