Cara Install Hermes Agent di Linux: Setup Aman untuk VPS, Server, dan Laptop

Linux adalah tempat paling natural untuk menjalankan Hermes Agent, terutama kalau targetnya agent operasional yang hidup 24 jam di VPS. Repo resmi Hermes Agent dari Nous Research memang menekankan bahwa Hermes bisa jalan di laptop, VPS murah, server GPU, sampai backend serverless. Untuk kebutuhan bisnis, VPS Linux biasanya paling masuk akal karena gateway, cron, memory, dan automation bisa tetap aktif tanpa bergantung ke laptop.

Artikel ini fokus ke instalasi Linux yang rapi: mulai dari dependency minimum, installer resmi, setup provider, verifikasi, sampai troubleshooting masalah yang paling sering muncul.

Referensi resmi:

• GitHub: https://github.com/NousResearch/hermes-agent
• Installation guide: https://hermes-agent.nousresearch.com/docs/getting-started/installation
• Quickstart: https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• FAQ resmi: https://hermes-agent.nousresearch.com/docs/reference/faq

Prasyarat minimum

Menurut dokumentasi resmi, pada non-Windows platform dependency yang benar-benar perlu disiapkan sebelum installer adalah Git. Dependency lain seperti uv, Python 3.11, Node.js 22, ripgrep, dan ffmpeg akan ditangani installer.

Di Ubuntu atau Debian:

sudo apt update sudo apt install -y git curl

Cek:

git --version curl --version

Untuk server produksi, saya tetap sarankan pakai user non-root khusus kalau Hermes akan dijalankan sebagai service jangka panjang. Root install bisa dipakai, tapi untuk hardening operasional, dedicated user lebih bersih.

Install Hermes Agent di Linux

Jalankan installer resmi:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Setelah selesai, reload shell:

source ~/.bashrc

Kalau memakai zsh:

source ~/.zshrc

Lalu cek instalasi:

hermes doctor

Kalau hasilnya bersih, lanjut setup:

hermes setup

Atau jalur cepat dengan Nous Portal:

hermes setup --portal

Struktur install di Linux

Untuk install per-user, data Hermes biasanya berada di:

~/.hermes/

Launcher command berada di:

~/.local/bin/hermes

Kalau command hermes tidak ditemukan, hampir selalu masalah PATH. Tambahkan ini ke shell profile:

export PATH="$HOME/.local/bin:$PATH"

Lalu reload:

source ~/.bashrc

Setup model provider

Setelah Hermes terpasang, pilih model:

hermes model

Hermes mendukung banyak provider: Nous Portal, OpenRouter, OpenAI, Anthropic, Gemini, GitHub Copilot, MiniMax, Kimi, Qwen, Hugging Face, Ollama, LM Studio, AWS Bedrock, Azure Foundry, dan custom endpoint OpenAI-compatible.

Rule praktisnya sederhana: jangan setup banyak hal sebelum chat dasar berhasil.

Jalankan:

hermes

Lalu test:

Cek folder saat ini dan jelaskan struktur project dalam 5 poin.

Kalau chat berhasil, baru lanjut ke gateway, cron, memory tuning, toolsets, MCP, atau browser automation.

Install untuk VPS atau service user

Kalau Hermes dijalankan di VPS, idealnya buat user khusus:

sudo adduser hermes sudo usermod -aG sudo hermes su - hermes

Lalu install sebagai user tersebut:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc hermes doctor

Untuk server minimal tanpa akses sudo, dokumentasi resmi menjelaskan bahwa installer bisa degrade dengan aman. Bagian yang biasanya butuh root adalah dependency sistem untuk Chromium Playwright. Jika browser automation tidak dipakai, jalankan:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

Kalau browser automation dibutuhkan, admin bisa memasang dependency Chromium satu kali:

sudo npx playwright install-deps chromium

Setelah itu jalankan installer Hermes sebagai user biasa.

Setup gateway setelah CLI stabil

Untuk Telegram, Discord, Slack, WhatsApp, dan platform lain:

hermes gateway setup

Lalu jalankan:

hermes gateway start hermes gateway status

Untuk VPS, pastikan firewall hanya membuka port yang benar-benar dibutuhkan. Banyak gateway messaging tidak butuh port publik langsung karena koneksi keluar ke platform. Jangan buka port hanya karena merasa server agent harus terlihat dari internet.

FAQ install Hermes Agent di Linux

Apakah perlu install Python manual?

Normalnya tidak. Installer resmi memakai uv dan menyiapkan Python 3.11. Install manual baru relevan kalau Tuan sengaja menjalankan setup developer dari source.

Apakah bisa install tanpa sudo?

Bisa untuk banyak skenario. Jika dependency browser system tidak bisa dipasang karena tidak ada sudo, installer akan memberi instruksi. Untuk server headless tanpa browser automation, pakai --skip-browser.

Apakah aman install sebagai root?

Bisa, tapi bukan default yang saya rekomendasikan untuk operasional bisnis. Pakai dedicated user agar config, logs, memory, dan akses file lebih mudah dibatasi.

Model lokal bisa dipakai?

Bisa. Gunakan hermes model, pilih custom endpoint, lalu arahkan ke endpoint OpenAI-compatible seperti Ollama, vLLM, SGLang, llama.cpp server, atau LM Studio. Pastikan context length minimal 64K sesuai requirement resmi Hermes.

Apakah Hermes cocok untuk VPS kecil?

Bisa, selama modelnya berjalan di cloud/API. Untuk model lokal besar, VPS kecil jelas tidak cukup. Untuk agent gateway, cron, dan tool ringan, VPS kecil masih masuk akal.

Troubleshooting Linux

1. hermes: command not found

Reload shell:

source ~/.bashrc

Atau tambahkan PATH manual:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc

Cek:

which hermes

2. ModuleNotFoundError: No module named dotenv

Ini biasanya terjadi karena yang dipanggil adalah file source Hermes dengan Python system, bukan launcher dari virtualenv. Jalankan:

which hermes hermes doctor

Pastikan command mengarah ke launcher yang dibuat installer, bukan file repo yang dieksekusi langsung.

3. Browser automation gagal karena dependency Chromium

Di Ubuntu/Debian, pasang dependency:

sudo npx playwright install-deps chromium

Kalau server tidak butuh browser automation:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

4. Tool terminal tidak melihat node, nvm, pyenv, atau asdf

Hermes membuat snapshot environment dari shell login. Jika tool yang Tuan butuhkan hanya dimuat di .zshrc, .bashrc, atau file init khusus, tambahkan init file ke config Hermes:

terminal: shell_init_files: - ~/.bashrc - ~/.zshrc - ~/.nvm/nvm.sh

Setelah itu restart session Hermes.

5. API key sudah diisi tapi model masih gagal

Jalankan:

hermes model hermes config check

Pastikan secret masuk ke ~/.hermes/.env, bukan cuma environment terminal sementara. Untuk setup pertama, lebih aman pakai command resmi daripada edit manual.

6. Gateway mati setelah logout SSH

Jangan jalankan gateway di sesi SSH biasa lalu logout. Pakai mekanisme service, process manager, atau command gateway install yang sesuai environment. Untuk produksi, jalankan gateway sebagai service user dan cek log secara rutin.

Kesimpulan operasional

Untuk Linux laptop, cukup install per-user lalu setup model. Untuk VPS, buat user khusus, jalankan installer sebagai user itu, verifikasi dengan hermes doctor, test chat biasa, baru aktifkan gateway. Jangan langsung campur semua fitur sebelum fondasi chat bersih.

Kalau Linux dipakai sebagai server operasional, lanjutkan dengan panduan VPS di https://ramadigital.id/blog/cara-install-hermes-agent-di-vps dan halaman layanan setup Hermes Agent di https://ramadigital.id/services/jasa-install-hermes-agent.