Chatbot biasa hanya bisa menjawab. Ia tidak bisa membuka folder, menjalankan perintah di komputer, atau mencari berkas yang kita butuhkan. Hermes Agent mencoba mengisi celah itu. Hermes Agent adalah kerangka kerja (framework) agen AI open-source yang dikembangkan Nous Research, dan bisa bekerja langsung di sistem kita. Pertanyaannya, bagaimana memasangnya untuk newbie? Tulisan ini menjawab pertanyaan itu, langkah demi langkah, untuk pengguna macOS dan Linux.
Mengenal Hermes Agent
Hermes berbeda dari chatbot di jendela browser. Ia bisa menggunakan alat (tool) untuk bertindak, misalnya menjalankan perintah terminal, menelusuri web, membaca berkas, dan berinteraksi dengan beberapa platform obrolan.
Otaknya berjalan di terminal, tetapi Hermes juga hadir dalam bentuk aplikasi desktop (Electron), dashboard web, dan TUI (antarmuka teks modern). Ia bisa dihubungkan ke Telegram, Discord, dan Slack. Hermes mendukung lebih dari 20 penyedia model AI, seperti OpenAI, Anthropic, Google, DeepSeek, xAI, OpenRouter, dan Nous Portal.
| Aspek | Keterangan |
|---|---|
| Pengembang | Nous Research |
| Platform | macOS, Linux, Windows, WSL2 |
| Antarmuka | Terminal, desktop, web, TUI, gateway obrolan |
| Model AI | Netral penyedia (lebih dari 20 penyedia) |
| Fitur utama | Skills, memori persisten, MCP, cron, webhook, bot, suara |
| Lokasi data | ~/.hermes/ |
Persiapan Sebelum Memulai
Pastikan perangkat Anda memenuhi syarat berikut:
- Sistem operasi macOS (zsh) atau Linux (bash). WSL2 juga didukung.
- Terminal: Terminal.app (macOS), iTerm2, atau terminal bawaan di VS Code.
- Koneksi internet untuk mengunduh installer dan mengakses API model.
- Untuk fitur browser dan computer-use, Chromium akan diunduh otomatis oleh installer.
Langkah 1: Instalasi
Ada dua jalur instalasi. Untuk pengguna yang baru pertama kali mencoba, jalur CLI biasanya lebih stabil. Jalur desktop lebih ramah bagi yang tidak nyaman dengan terminal.
Jalur A: Instalasi CLI (direkomendasikan untuk pemula)
Jalankan perintah berikut di terminal:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Skrip ini akan meng-clone repositori sumber, memasang Python terkelola, lalu menyiapkan dependensi dan launcher. Jika proses berhasil, Anda akan melihat pesan bahwa Hermes Agent terpasang. Buka shell baru setelah itu agar perintah hermes dikenali.
Jalur B: Installer desktop (macOS dan Windows)
- Buka https://hermes-agent.nousresearch.com dan unduh installer sesuai sistem operasi (DMG untuk macOS atau MSIX untuk Windows).
- Pada macOS, seret Hermes.app ke folder Applications. Pada Windows, jalankan berkas instalasinya.
- Aplikasi akan menyiapkan folder
~/.hermes/dan langsung membuka wizard pengaturan.
Jika perintah hermes belum dikenali
Skrip instalasi biasanya membuat launcher di ~/.local/bin/hermes. Jika perintah tetap tidak ditemukan, tambahkan baris berikut ke ~/.zshrc (macOS) atau ~/.bashrc (Linux):
export PATH="$HOME/.local/bin:$PATH"
Lalu muat ulang shell:
source ~/.zshrc # macOS
source ~/.bashrc # Linux
Langkah 2: Verifikasi Instalasi
Pastikan Hermes sudah siap dengan dua perintah sederhana:
hermes --version
hermes --help
Perintah pertama menampilkan nomor versi. Perintah kedua menampilkan daftar seluruh subperintah yang tersedia. Jika muncul pesan command not found, jalankan source ~/.zshrc terlebih dahulu, lalu periksa kembali PATH Anda.
Langkah 3: Menghubungkan Model AI
Hermes membutuhkan otak, yaitu model AI. Ada tiga cara untuk menghubungkannya.
Nous Portal (paling praktis). Satu langganan mencakup lebih dari 300 model dan Tool Gateway, yang meliputi pencarian web, pembuatan gambar, text-to-speech, dan cloud browser. Anda tidak perlu mengelola API key secara manual.
hermes setup --portal
Browser akan terbuka untuk login OAuth. Setelah itu, pilih model yang Anda inginkan. Tool Gateway akan aktif otomatis.
Pilih penyedia secara manual. Cocok jika Anda sudah memiliki API key dari Anthropic, OpenAI, Google, DeepSeek, xAI, atau OpenRouter.
hermes model
Pilih penyedia dari daftar, masukkan API key jika diminta, lalu tentukan model yang digunakan.
Wizard lengkap. Jika ingin mengatur semuanya sekaligus (model, tools, terminal, gateway), jalankan:
hermes setup
Setelah itu, periksa kondisi sistem dengan:
hermes doctor
Perintah ini menampilkan status setiap komponen, seperti Python, PATH, API key, dan tools. Perbaiki bagian yang ditandai merah sebelum mulai mengobrol.
Langkah 4: Menjalankan Hermes
Ada beberapa cara memulai percakapan, tergantung kebutuhan Anda.
# CLI klasik: obrolan interaktif
hermes
# TUI modern (direkomendasikan)
hermes --tui
# Satu pertanyaan, langsung dijawab tanpa mode interaktif
hermes chat -q "Ringkas proyek ini dalam tiga poin"
# Melanjutkan sesi terakhir
hermes --continue
hermes -c
Contoh percakapan di TUI:
hermes --tui
✦ Hermes v0.4.x
model: Anthropic/claude-3-5-sonnet
tools: terminal · file · web · browser · voice
> Apa perintah untuk melihat direktori terbesar di Home?
[Hermes menjalankan perintah dan menampilkan hasilnya]
5 direktori terbesar:
4.2 GB ./Documents
1.8 GB ./Downloads
Daftar Perintah Inti
| Perintah | Fungsi |
|---|---|
hermes | Memulai obrolan interaktif (CLI) |
hermes --tui | Memulai TUI modern |
hermes chat -q "..." | Satu pertanyaan, hasil langsung |
hermes --version | Menampilkan versi |
hermes --help | Daftar perintah dan flag |
hermes model | Memilih model atau penyedia |
hermes setup | Wizard konfigurasi lengkap |
hermes setup --portal | Setup cepat lewat Nous Portal |
hermes doctor | Mendiagnosis masalah instalasi |
hermes tools list/enable/disable | Mengatur tools aktif per platform |
hermes skills list/browse/install | Mengelola skill |
hermes mcp add/list | Mengelola MCP server |
hermes gateway setup/run/status | Menghubungkan platform obrolan |
hermes config get/set | Membaca dan menulis konfigurasi |
hermes update | Memperbarui ke rilis terbaru |
hermes sessions list | Daftar sesi yang tercatat |
hermes logs | Melihat log agen dan gateway |
hermes desktop | Membuka aplikasi desktop |
hermes dashboard | Membuka panel admin web |
Fitur Dasar yang Perlu Dikenal
Menjalankan perintah terminal. Anda cukup bertanya dalam bahasa biasa, lalu Hermes menjalankan perintah yang diperlukan dan menampilkan hasilnya. Contohnya: “Berapa ukuran total folder Documents dan Downloads?”
Slash commands di dalam sesi. Selama obrolan berlangsung, beberapa perintah berawalan garis miring dapat dipakai:
| Slash command | Fungsi |
|---|---|
/help | Daftar perintah yang tersedia |
/tools | Melihat tools yang aktif |
/model | Mengganti model secara interaktif |
/personality pirate | Mencoba gaya kepribadian tertentu |
/save | Menyimpan percakapan |
/voice on | Mengaktifkan mode suara (tekan Ctrl+B untuk merekam) |
Pemecahan Masalah
| Masalah | Solusi |
|---|---|
hermes: command not found | Jalankan source ~/.zshrc (macOS) atau source ~/.bashrc (Linux), lalu periksa PATH |
| API key belum diatur | Jalankan hermes model, atau atur langsung dengan hermes config set OPENROUTER_API_KEY nilai_key |
| Konfigurasi hilang setelah update | Jalankan hermes config check, lalu hermes config migrate |
hermes doctor menampilkan error | Baca instruksi perbaikan yang ditampilkan, lalu jalankan hermes doctor lagi |
| Perintah terminal ditolak | Jalankan hermes tools enable shell, atau gunakan mode sandbox Docker |
Lokasi Berkas Penting
| Lokasi | Isi |
|---|---|
~/.hermes/config.yaml | Pengaturan utama (tanpa rahasia) |
~/.hermes/.env | API key dan secret. Jangan dibagikan. |
~/.hermes/auth.json | Token OAuth dan credential pool |
~/.hermes/state.db | Riwayat sesi (SQLite dengan FTS5) |
~/.hermes/sessions/ | Transkrip dan routing sesi |
~/.hermes/logs/ | Log gateway dan error |
~/.hermes/skills/ | Skill yang sudah terpasang |
~/.hermes/profiles/ | Profil terpisah, jika digunakan |
Langkah Berikutnya
Setelah Hermes berjalan, ada beberapa hal yang bisa dicoba:
- Menghubungkan Hermes ke Telegram, Discord, atau Slack dengan
hermes gateway setup. - Memasang skill sesuai kebutuhan dengan
hermes skills install <id>. - Menambahkan MCP server dengan
hermes mcp add. - Membuat jadwal otomatis dengan
hermes cron create. - Membuka aplikasi desktop dengan
hermes desktop.
Panduan resmi tersedia di: