Saya sempat mengira Ai Hermes Agent hanya enak dipakai lewat WSL2 atau Linux.
Ternyata, setelah dicoba pelan pelan di Windows native, Hermes tetap bisa jalan normal di PC atau laptop tanpa harus memindahkan semua workflow ke Ubuntu.
Prosesnya memang tidak mulus sejak awal.
Kadang di windows, ada error dependency Python, ada virtual environment yang rusak, lalu ada juga kebingungan kecil saat menjalankan perintah dari folder yang salah.
Tetapi justru dari situ saya belajar bahwa masalahnya bukan Hermes selalu berat, melainkan setup environment yang belum rapi aja.
Kalau Anda sedang mencari cara install Hermes di Windows untuk dipakai di PC atau laptop sendiri, tulisan ini saya susun dari pengalaman pribadi.
Jadi alurnya saya buat sederhana, praktis, dan tetap relevan untuk orang yang ingin langsung mencoba, bukan sekadar membaca teori.
Di bawah ini saya rangkum langkahnya supaya lebih enak diikuti.
Anda bisa langsung lompat ke bagian yang dibutuhkan lewat daftar isi berikut.
Daftar Isi
Kondisi awal yang membuat Hermes error
Awalnya Hermes menampilkan error seperti ModuleNotFoundError: No module named 'requests'.
Setelah itu muncul lagi error lain, lalu berikutnya No module named pip, kemudian ModuleNotFoundError: No module named 'rich'.
Dari situ saya sadar bahwa yang bermasalah bukan aplikasi Hermes semata, tetapi environment Python yang dipakai di PCku untuk menjalankannya.
Dalam kasus seperti ini, biasanya akar masalahnya ada di virtual environment yang korup, dependency yang belum lengkap, atau instalasi yang sebelumnya terputus di tengah jalan.
Jadi saya tidak buru buru menyalahkan aplikasinya dulu.
Saya pilih bereskan lingkungan Python-nya satu per satu.
Solusi yang berhasil dipakai
Langkah paling bersih adalah membuat ulang virtual environment Hermes.
Saya masuk ke folder project Hermes, lalu menghapus folder venv lama, membuat ulang venv, mengaktifkannya, kemudian memperbarui pip.
cd C:\Users\anda\AppData\Local\hermes\hermes-agent
Remove-Item -Recurse -Force .\venv
python -m venv venv
.\venv\Scripts\Activate.ps1
python -m pip install --upgrade pipSetelah itu, saya install dependency dari root project, bukan dari folder lain. Ini penting sekali karena Hermes memakai file pyproject.toml sebagai acuan instalasi.
Jadi perintah yang benar adalah menjalankan install editable dari folder project Hermes.
python -m pip install -e .Kesalahan yang hampir membuat bingung
Di tengah proses, saya sempat menjalankan perintah instalasi dari C:\Windows\system32.
Akibatnya, pip membaca folder system32 sebagai project Python, lalu keluar error bahwa folder itu bukan project Python karena tidak ada setup.py atau pyproject.toml.
Dari situ pelajarannya jelas.
Saat install Hermes, pastikan prompt PowerShell sudah berada di folder root Hermes.
Jangan sampai menjalankan python -m pip install -e . dari folder sembarang.
Kalau foldernya benar, maka pip akan membaca konfigurasi project dengan benar dan dependency Hermes bisa terpasang sesuai kebutuhan.
Install dependency Hermes dengan benar
Setelah saya pindah ke folder yang tepat, proses instalasi berjalan lebih rapi.
Beberapa package seperti requests dan rich memang sempat perlu dipasang ulang, tetapi setelah environment dibangun kembali, Hermes mulai stabil.
python -m pip install requests
python -m pip install richNamun inti utamanya tetap sama.
Jangan terlalu fokus pada package satu per satu kalau root project belum benar.
Pastikan dulu bahwa Anda berada di folder Hermes yang memiliki pyproject.toml, lalu jalankan install editable agar dependency utama ikut terbaca.
Cara menjalankan Hermes di Windows
Ini bagian yang sempat bikin saya tersendat.
Saya mencoba menjalankan .\hermes, lalu Windows malah menampilkan dialog untuk memilih aplikasi pembuka file.
Ternyata itu wajar, karena file hermes di root project bukan launcher Windows yang bisa dibuka langsung dengan cara itu.
Perintah yang benar justru cukup:
hermesAtau jika perlu, jalankan launcher yang ada di dalam virtual environment:
.\venv\Scripts\hermes.exeSetelah saya menjalankan command yang tepat, Hermes akhirnya hidup normal.
Dari sini saya bisa lanjut pakai Hermes di Windows native tanpa harus pindah ke WSL.
Penutup
Sebagai ringkasan, kami bubuhkan tabel masalah dan solusi saat install hermes di PCku, kiranya kamu menemukan hal sama:
| Masalah / Error yang Muncul | Solusi Perintah (Command) | Keterangan |
|---|---|---|
ModuleNotFoundError: No module named 'requests' atau rich | python -m pip install requestspython -m pip install rich | Install package yang hilang. Tetapi lebih baik lakukan perbaikan environment secara bersih agar hasilnya stabil. |
No module named 'pip' | python -m ensurepip --upgrade | Memastikan pip terinstal di virtual environment. |
Virtual environment (venv) korup atau error | Remove-Item -Recurse -Force .\venvpython -m venv venv.\venv\Scripts\Activate.ps1 | Hapus folder venv lama, buat ulang, lalu aktifkan kembali environment-nya. |
| Error saat install, terutama karena folder salah | cd C:\...\hermes-agentpython -m pip install -e . | Pastikan terminal berada di root project yang berisi file pyproject.toml, lalu jalankan install editable. |
Menjalankan .\hermes malah membuka dialog pilih aplikasi | hermes.\venv\Scripts\hermes.exe | Jalankan command hermes langsung, atau panggil file .exe di dalam folder venv. |
Bagi saya, pengalaman ini cukup melegakan.
Ternyata install Hermes di Windows tidak selalu harus rumit pakai WSL WSLan.
Selama environment Python dirapikan, dependency dipasang dari root project yang benar, dan command dijalankan sesuai cara kerja PowerShell, Hermes bisa berjalan baik di PC maupun laptop Windows.
Jadi kalau Anda sedang mencari cara install Hermes Agent di Windows native, jangan langsung panik ketika muncul error dependency.
Cek dulu folder project, cek venv, lalu install ulang dengan alur yang benar.
Kadang yang terlihat seperti masalah besar ternyata hanya soal urutan langkah yang belum tepat.
Kalau mentok, ya udah tanya Gemini atau ChatGPT buat memandu ya.
Anjrah Ari Susanto, S.Psi.
No comment yet, add your voice below!