Cara Install Hermes Agent di Windows: Native PowerShell, WSL2, dan Troubleshooting

Hermes Agent sekarang sudah bisa jalan native di Windows 10 dan Windows 11. Ini penting, karena user Windows tidak wajib masuk WSL2 hanya untuk mencoba Hermes. Menurut repo resmi Nous Research dan dokumentasi Hermes Agent, installer native Windows sudah menyiapkan dependency utama seperti Python 3.11, Node.js 22, ripgrep, ffmpeg, uv, dan PortableGit.

Kalau tujuan Tuan cuma ingin Hermes berjalan cepat di laptop Windows, jalur paling praktis adalah installer Desktop atau PowerShell native. Kalau tujuannya setup yang lebih dekat dengan environment server Linux, WSL2 tetap masuk akal.

Referensi resmi yang dipakai di artikel ini:

• GitHub: https://github.com/NousResearch/hermes-agent
• Installation guide: https://hermes-agent.nousresearch.com/docs/getting-started/installation
• Windows native guide: https://hermes-agent.nousresearch.com/docs/user-guide/windows-native
• FAQ resmi: https://hermes-agent.nousresearch.com/docs/reference/faq

Pilih jalur install dulu

Ada tiga pilihan yang realistis di Windows.

Pertama, Hermes Desktop. Ini jalur paling ramah untuk user yang ingin command-line dan desktop app sekaligus. Download dari halaman resmi Hermes Desktop, lalu jalankan installer.

Kedua, native PowerShell. Ini cocok kalau Tuan ingin install command-line saja tanpa WSL. Jalur ini resmi didukung dan tidak butuh admin rights untuk instalasi normal.

Ketiga, WSL2. Ini cocok untuk developer yang ingin environment Linux di dalam Windows, atau butuh dashboard chat pane yang memakai POSIX PTY. Native Windows sudah support CLI, TUI, gateway, cron, browser tool, dan MCP. Tapi menurut dokumentasi resmi, chat pane dashboard berbasis embedded terminal masih lebih cocok di WSL2.

Cara install Hermes Agent native di Windows

Buka PowerShell atau Windows Terminal, lalu jalankan:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Installer akan memasang Hermes ke:

%LOCALAPPDATA%\hermes

Setelah installer selesai, buka terminal baru. Ini penting karena PATH baru biasanya belum kebaca di terminal lama.

Lalu cek:

hermes doctor

Kalau sudah bersih, lanjut:

hermes setup

Atau kalau ingin jalur cepat memakai Nous Portal:

hermes setup --portal

Nous Portal adalah opsi resmi dari Nous Research untuk menyatukan akses model dan beberapa tool seperti web search, image generation, TTS, dan cloud browser dalam satu login OAuth. Kalau tidak pakai Portal, Tuan bisa pilih provider lain lewat:

hermes model

Cara install Hermes Agent via WSL2

Kalau memilih WSL2, install dulu WSL2 dari Windows:

wsl --install

Masuk ke distro Linux, misalnya Ubuntu, lalu pastikan Git tersedia:

git --version

Jika belum ada:

sudo apt update sudo apt install -y git

Setelah itu jalankan installer Linux resmi:

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

Reload shell:

source ~/.bashrc

Lalu cek:

hermes doctor hermes setup

Data native Windows dan WSL2 terpisah. Native Windows memakai %LOCALAPPDATA%\hermes untuk instalasi dan %USERPROFILE%.hermes untuk data. WSL2 memakai struktur Linux seperti ~/.hermes.

Setup provider model

Hermes tidak akan berguna sebelum ada model provider yang aktif. Jalur paling simpel:

hermes model

Pilih provider yang Tuan pakai. Hermes mendukung Nous Portal, OpenRouter, OpenAI, Anthropic, Gemini, GitHub Copilot, MiniMax, Kimi, Qwen, Hugging Face, Ollama, LM Studio, dan custom OpenAI-compatible endpoint.

Untuk penggunaan pertama, jangan langsung setup gateway Telegram, WhatsApp, cron, atau MCP. Pastikan chat normal jalan dulu:

hermes

Coba prompt sederhana:

Ringkas folder kerja saya dalam 5 poin.

Kalau Hermes bisa jawab dan bisa pakai tool dasar, baru lanjut ke fitur lain.

Setup gateway di Windows

Setelah CLI jalan, baru setup messaging gateway:

hermes gateway setup

Untuk menjalankan gateway otomatis saat login:

hermes gateway install hermes gateway status

Di Windows, Hermes memakai Scheduled Tasks atau fallback Startup folder. Ini tidak butuh admin untuk skenario normal.

FAQ install Hermes Agent di Windows

Apakah Hermes Agent harus pakai WSL2?

Tidak. Native Windows sudah resmi didukung. WSL2 hanya lebih cocok kalau Tuan butuh lingkungan Linux, workflow yang dekat dengan server, atau fitur dashboard chat pane berbasis terminal POSIX.

Apakah perlu install Python dan Node.js manual?

Normalnya tidak. Installer resmi menyiapkan Python 3.11 via uv, Node.js 22, ripgrep, ffmpeg, dan PortableGit kalau belum ada.

Apakah installer butuh admin?

Untuk instalasi native normal, tidak. Installer menulis ke %LOCALAPPDATA%\hermes dan menambahkan command hermes ke User PATH.

Kalau sudah punya Git, apakah Hermes tetap install PortableGit?

Installer akan mendeteksi Git yang sudah ada. Kalau Git tidak ada, installer akan menyiapkan PortableGit yang isolated dan tidak mengganggu instalasi Git sistem.

Bisa pakai OpenRouter atau model lokal?

Bisa. Gunakan hermes model. Untuk model lokal seperti Ollama atau LM Studio, pastikan endpoint OpenAI-compatible aktif dan context length cukup. Dokumentasi resmi menyebut Hermes butuh minimal 64K context untuk workflow agentic yang stabil.

Troubleshooting Windows

1. hermes tidak dikenali setelah install

Biasanya terminal belum membaca PATH baru. Tutup PowerShell atau Windows Terminal, buka lagi, lalu jalankan:

hermes doctor

Kalau masih gagal, cek apakah shim ada di:

%LOCALAPPDATA%\hermes\bin

2. PowerShell memblokir script

Jalankan PowerShell normal, bukan mode restricted corporate shell. Kalau environment kantor memblokir remote script, download installer resmi dari dokumentasi Hermes atau pakai jalur Desktop installer.

3. Unicode error atau karakter aneh di terminal

Gunakan Windows Terminal modern. Dokumentasi Windows native Hermes menjelaskan bahwa Hermes sudah mengatur UTF-8 console lebih awal di entrypoint, tapi terminal lama masih bisa bikin output tidak nyaman.

4. Browser tool gagal pertama kali

Browser tool butuh Node.js dan Playwright Chromium. Installer menyiapkan Node.js, lalu Chromium biasanya dipasang saat pertama kali tool browser dipakai. Jalankan:

hermes doctor

Ikuti fix yang muncul.

5. Gateway tidak jalan saat startup

Cek:

hermes gateway status

Kalau task tidak ada, reinstall:

hermes gateway uninstall hermes gateway install

6. Ingin pindah dari native Windows ke WSL2

Install WSL2 dan jalankan installer Linux dari dalam WSL. Jangan copy folder %LOCALAPPDATA%\hermes langsung ke WSL. Yang lebih penting untuk dipindah adalah data dan konfigurasi dari %USERPROFILE%.hermes, lalu sesuaikan path dan secrets dengan hati-hati.

Kesimpulan operasional

Untuk user bisnis atau operator non-teknis, mulai dari Hermes Desktop atau native PowerShell. Untuk developer yang sering kerja dengan server Linux, WSL2 lebih enak. Urutannya tetap sama: install, jalankan hermes doctor, setup model, test chat biasa, baru aktifkan gateway dan automation.

Kalau targetnya bukan sekadar coba di laptop, baca juga panduan VPS di https://ramadigital.id/blog/cara-install-hermes-agent-di-vps dan halaman layanan setup di https://ramadigital.id/services/jasa-install-hermes-agent.