Cara Install Hermes Agent di macOS: Desktop Installer, Terminal, dan Troubleshooting

Di macOS, Hermes Agent punya dua jalur install yang sama-sama resmi: Hermes Desktop untuk user yang ingin pengalaman lebih visual, dan command-line installer untuk user yang nyaman bekerja dari Terminal. Untuk mayoritas user teknis, command-line installer cukup cepat. Untuk user bisnis atau operator yang tidak mau terlalu dekat dengan terminal, Desktop installer lebih ramah.

Yang penting: jangan install asal dari tutorial lama. Repo resmi Hermes Agent aktif berubah, dan dokumentasi resmi sekarang menempatkan Desktop installer sebagai jalur mudah untuk macOS/Windows, sementara command-line installer tetap tersedia untuk macOS, Linux, WSL2, Android Termux.

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

Pilih jalur install di macOS

Gunakan Hermes Desktop kalau Tuan ingin command-line dan desktop app sekaligus. Download dari:

https://hermes-agent.nousresearch.com/desktop

Gunakan command-line installer kalau Tuan ingin setup yang ringan dan mudah dipakai dari Terminal:

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

Untuk Mac yang dipakai sebagai mesin kerja harian, command-line install biasanya cukup. Untuk tim non-teknis, Desktop installer lebih mudah dijelaskan.

Prasyarat macOS

Dokumentasi resmi menyebut Git sebagai prasyarat utama di non-Windows platform. Di macOS, Git biasanya tersedia setelah Command Line Tools terpasang.

Cek:

git --version

Kalau macOS meminta install Command Line Tools, ikuti prompt. Bisa juga jalankan:

xcode-select --install

Setelah Git aktif, jalankan installer Hermes.

Install Hermes Agent via Terminal

Di Terminal:

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

Setelah selesai, reload shell:

source ~/.zshrc

macOS modern default-nya zsh. Kalau Tuan memakai bash:

source ~/.bashrc

Cek:

hermes doctor

Lalu setup:

hermes setup

Atau gunakan jalur cepat Nous Portal:

hermes setup --portal

Setup model provider

Hermes butuh provider model sebelum bisa dipakai. Jalankan:

hermes model

Pilih provider sesuai kebutuhan. Untuk user baru, Nous Portal atau OpenRouter biasanya paling cepat dipahami karena tidak perlu terlalu banyak konfigurasi endpoint. Untuk user yang sudah punya stack sendiri, custom endpoint juga bisa.

Setelah model aktif, test chat:

hermes

Prompt test:

Cek direktori saat ini dan jelaskan isi utamanya dalam 5 poin.

Kalau ini berhasil, baru lanjut ke gateway, toolsets, browser, MCP, atau cron.

Install Hermes Desktop setelah CLI

Jika Tuan mulai dari command-line dan kemudian ingin Desktop, dokumentasi resmi menyebut bisa menjalankan:

hermes desktop

Jalur ini berguna kalau Hermes sudah terpasang, tetapi user ingin UI desktop tanpa mengulang semua setup dari nol.

Catatan untuk Apple Silicon dan Intel Mac

Installer resmi seharusnya menangani dependency utama. Namun di Mac yang sudah lama dipakai developer, masalah sering bukan dari Hermes, tapi dari PATH yang terlalu ramai: Homebrew, pyenv, nvm, asdf, Conda, dan shell profile yang saling tumpang tindih.

Sebelum menyalahkan Hermes, cek dulu:

which git which python3 which node echo $SHELL

Lalu jalankan:

hermes doctor

Ikuti output diagnosisnya.

Setup gateway di macOS

Setelah CLI stabil:

hermes gateway setup

Untuk menjalankan gateway:

hermes gateway start hermes gateway status

Jika Hermes dipakai untuk Telegram, Discord, Slack, atau WhatsApp gateway di mesin personal, pastikan Mac tidak sering sleep. Untuk agent operasional 24 jam, VPS Linux tetap lebih aman daripada MacBook pribadi.

FAQ install Hermes Agent di macOS

Lebih baik Desktop installer atau Terminal?

Kalau targetnya user non-teknis, Desktop installer. Kalau targetnya developer atau operator, Terminal lebih cepat dan mudah diaudit.

Apakah perlu Homebrew?

Tidak wajib menurut jalur install resmi. Git adalah prasyarat utama. Dependency lain ditangani installer. Homebrew tetap berguna untuk environment developer, tapi jangan jadikan syarat kalau tidak perlu.

Apakah perlu install Python manual?

Normalnya tidak. Installer menyiapkan Python 3.11 via uv. Install manual hanya perlu kalau Tuan memilih jalur developer install dari source.

Bisa pakai Ollama di Mac?

Bisa. Jalankan Ollama atau LM Studio, lalu pilih custom endpoint dari hermes model. Pastikan context length minimal 64K. Kalau model lokal terlalu kecil atau context-nya pendek, Hermes bisa gagal menjaga workflow agentic yang panjang.

Bisa dipakai untuk automation 24 jam?

Bisa, tapi MacBook bukan tempat ideal untuk agent yang harus selalu hidup. Kalau butuh gateway, cron, dan monitoring jalan 24 jam, VPS Linux lebih stabil.

Troubleshooting macOS

1. git: command not found

Install Command Line Tools:

xcode-select --install

Setelah selesai:

git --version

2. hermes: command not found

Reload shell:

source ~/.zshrc

Kalau masih gagal:

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

3. PATH kacau karena Homebrew, pyenv, nvm, atau asdf

Masalah umum di Mac developer adalah dependency ada, tapi tidak terlihat oleh environment Hermes. Tambahkan init file yang dibutuhkan ke config:

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

Setelah itu restart Hermes.

4. Browser automation gagal

Jalankan:

hermes doctor

Jika masalahnya Playwright atau Chromium, ikuti instruksi yang muncul. Jangan langsung reinstall Hermes sebelum tahu dependency mana yang kurang.

5. OAuth provider tidak membuka browser dengan benar

Pastikan default browser macOS normal dan tidak diblokir oleh profile kantor. Kalau login OAuth gagal, coba jalankan lagi:

hermes model

Pilih provider yang sama dan ulangi flow. Untuk environment yang strict, API key manual kadang lebih stabil daripada OAuth.

6. Hermes lambat dengan model lokal

Model lokal di Mac bergantung pada RAM, chip, quantization, dan context length. Kalau context 64K dipaksa pada model besar, latency bisa tinggi. Untuk kerja operasional, pertimbangkan provider cloud atau model yang memang sanggup context besar.

Kesimpulan operasional

Di macOS, mulai dari Desktop installer kalau targetnya mudah dipakai, atau command-line installer kalau targetnya kontrol teknis. Setelah install, urutannya tetap: hermes doctor, hermes setup atau hermes setup --portal, test chat normal, baru aktifkan gateway dan fitur lanjutan. Untuk agent yang harus hidup 24 jam, pindahkan ke VPS Linux setelah konfigurasi dasar matang.

Kalau Tuan ingin membandingkan setup laptop dengan setup server, baca juga https://ramadigital.id/blog/cara-install-hermes-agent-di-vps dan halaman layanan https://ramadigital.id/services/jasa-install-hermes-agent.