Menginstal Hermes Agent di Mac mini
Hermes Agent terpasang di Mac Apple silicon dengan satu script. Script itu menyiapkan Python dan tool-nya sendiri. Lalu dua perintah memilih model dan menjadikan gateway pesan sebagai layanan launchd. Ini langkah resminya, output dari instalasi test kami, dan cara menjaganya tetap menyala sepanjang waktu.
Apa itu Hermes Agent
Hermes Agent adalah agen open source dari Nous Research, dengan lisensi MIT. Agen ini menyimpan memori antarsesi dan menulis skill-nya sendiri saat mempelajari pekerjaan Anda. Gateway menghubungkannya ke Telegram, Discord, WhatsApp, dan aplikasi chat lain (github.com/NousResearch/hermes-agent, Oktober 2026).
Anda bisa memakainya sebagai chat di terminal, seperti coding agent lain. Atau Anda bisa membiarkan gateway berjalan dan mengirim pesan dari ponsel. Cara kedua inilah alasan orang ingin menjalankannya di Mac yang selalu menyala.
Kebutuhan
- Apple silicon. Dokumentasi instalasinya menyebut installer macOS hanya untuk Apple silicon, dan Mac Intel tidak didukung (Oktober 2026).
- Python 3.11 sampai 3.14, git, dan curl. Installer menyiapkan Python, Node, ffmpeg, dan ripgrep sendiri, jadi Mac yang masih bersih tidak masalah.
- Sebuah model. Hermes bekerja dengan Anthropic, OpenAI, OpenRouter, Nous Portal, dan banyak lainnya. Dokumentasi penyedianya mencantumkan API key, login lewat browser, dan beberapa paket langganan. Hermes juga menerima endpoint lokal apa pun yang kompatibel dengan OpenAI, seperti Ollama.
Instal
Ini perintah terdokumentasi untuk macOS. Muat ulang shell Anda setelahnya.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.zshrc
Untuk script atau shell remote, installer menerima flag yang melewati pertanyaan serta tool browser dan computer-use yang opsional. Kami memakainya untuk test kami.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use
Kami menjalankannya dua kali di mesin macOS 26 hosted GitHub pada 2 Oktober 2026. Sekali butuh sekitar 2 menit, dan sekali lagi 6.5 menit, sebagian besar untuk unduhan. Pengecekan versi menampilkan ini.
$ hermes --version Hermes Agent v0.21.5+5635.g5bba024 (2026.9.24) · upstream 5bba024d
Ada gunanya tahu apa yang dipasang di mana. Installer meng-clone kode ke folder hermes di direktori home Anda. Installer menaruh salinan Python 3.14.7, Node, ffmpeg, dan ripgrep miliknya sendiri di folder tools di dalamnya. Perintah hermes masuk ke folder local bin di direktori home Anda. Installer juga menambahkan 58 skill bawaan, termasuk untuk Apple Notes, Reminders, dan iMessage. Itu salah satu alasan menjalankan Hermes di Mac, bukan di mesin Linux.
Sekarang pilih model dan jalankan wizard setup.
hermes model hermes setup hermes doctor
Pindahan dari OpenClaw? README-nya mencantumkan perintah yang mengimpor pengaturan OpenClaw Anda.
hermes claw migrate
Jaga gateway tetap berjalan 24/7
Pertama, hubungkan aplikasi chat Anda. Lalu pasang gateway sebagai layanan. Di macOS, itu berupa agen launchd.
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status tail -f ~/.hermes/logs/gateway.log
Kami menjalankan perintah install di mesin test yang belum punya aplikasi chat. User-nya bernama runner. Pengecekan status memastikan launchd menjalankan gateway.
$ hermes gateway install Installing launchd service to: /Users/runner/Library/LaunchAgents/ai.hermes.gateway.plist ✓ Service installed and loaded! $ hermes gateway status ✓ Service definition matches the current Hermes install ✓ Gateway is supervised by launchd (PID 14390) Auto-start at login and auto-restart on crash are available.
File layanan diatur untuk berjalan saat dimuat, jadi muncul lagi di setiap login. File itu juga me-restart gateway jika keluar dengan error. Ada satu jebakan dari dokumentasi messaging. Jika nanti Anda memasang tool baru, jalankan perintah install lagi agar layanan memakai PATH yang baru.
Seperti LaunchAgent lain, layanan ini butuh user yang login. Aktifkan login otomatis, lalu matikan mode tidur.
sudo pmset -a sleep 0 sudo pmset -a disksleep 0 sudo pmset -a displaysleep 10
Untuk sesi terminal yang bertahan saat koneksi putus, jalankan agen interaktif di dalam tmux. Langkahnya ada di panduan tmux kami. Langkahnya sama untuk Hermes.
Catatan keamanan
- Gateway menolak semua orang sampai Anda mengizinkannya. Atur allowlist berisi user ID, atau setujui orang satu per satu dengan kode pairing. Kode kedaluwarsa setelah satu jam.
- Approval punya tiga mode: manual, smart, dan off. Off sama dengan flag yolo. Biarkan di manual sampai Anda percaya pada setup Anda.
- Simpan API key di file env di folder hermes, yang hanya bisa dibaca oleh Anda. Jangan pernah meng-commit-nya.
- Untuk isolasi lebih, dokumentasi keamanannya menunjukkan cara menjalankan perintah di container Docker, bukan langsung di Mac.
# in ~/.hermes/.env TELEGRAM_ALLOWED_USERS=123456789 # or approve one person by pairing code hermes pairing approve telegram XKGH5N7P chmod 600 ~/.hermes/.env
Menurut dokumentasinya, beberapa perlindungan tetap berlaku bahkan di mode yolo. Blocklist tetap menghentikan perintah seperti penghapusan rekursif seluruh disk. Tool file-nya menolak menulis ke folder ssh dan aws.
Menjalankannya di Mac MacRun
Paket agen kami memberi Anda Mac mini khusus dengan mode tidur mati. Sesi login-nya kembali sendiri setelah reboot. Claude Code dan Codex sudah terpasang. Hermes tidak. Anda memasangnya dengan script di atas memakai akses admin Anda. Jika Hermes memakai model cloud, M6 dasar dengan 16 GB sudah lebih dari cukup.
Siapa yang sebaiknya tidak menyewa Mac untuk ini. Hermes juga berjalan di Linux. Jika Anda tidak butuh Xcode, Apple Notes, atau iMessage, server Linux lebih murah. Dan MacRun untuk pekerjaan developer, jadi pakai untuk coding, build, dan tugas rutin repo, bukan sebagai asisten kehidupan pribadi.
Lihat isi paket agen di halaman Mac untuk agen.
Pertanyaan yang sering diajukan
Apakah Hermes Agent berjalan di Mac Intel?
+
Tidak. Dokumentasi instalasi Hermes Agent menyebut installer macOS hanya mendukung Apple silicon, per Oktober 2026.
Bagaimana cara menjalankan Hermes Agent di latar belakang di macOS?
+
Jalankan hermes gateway install. Perintah itu membuat agen launchd yang berjalan saat login. Pakai hermes gateway start, stop, dan status untuk mengelolanya.
Bisakah Hermes Agent memakai model lokal?
+
Bisa. Dokumentasi penyedianya menyebut Hermes bekerja dengan endpoint apa pun yang kompatibel dengan OpenAI, termasuk Ollama dan LM Studio. Pilih dengan hermes model.
Di mana Hermes Agent menyimpan API key?
+
Di file env di dalam folder hermes di direktori home Anda. Dokumentasi keamanannya menyarankan chmod 600 untuk file itu dan tidak pernah meng-commit-nya.