Instalasi Hermes dan Konfigurasi OmniProxy

Hermes adalah asisten yang dapat menyimpan percakapan dan pengalaman dari berbagai tugas. Pekerjaan yang pernah dilakukan dapat disusun menjadi keterampilan untuk digunakan kembali. Hermes juga dapat terhubung ke Telegram, Discord, Slack, WhatsApp, Signal, dan terminal melalui Gateway yang sama. Gateway dapat dipahami sebagai pintu masuk terpadu untuk menerima dan meneruskan pesan. Anda dapat memberikan tugas seperti peninjauan kode, pencatatan insiden, atau pengolahan materi pelanggan melalui aplikasi percakapan yang biasa digunakan, lalu memintanya melanjutkan pekerjaan di repositori.

Persiapan sebelum instalasi

Pilih metode instalasi berdasarkan sistem komputer Anda. macOS dan Windows dapat langsung menggunakan paket instalasi dengan antarmuka grafis, sedangkan Linux, macOS, dan WSL2 dapat menggunakan skrip terminal. WSL2 adalah fitur untuk menjalankan lingkungan Linux di Windows. Termux di ponsel Android dan Docker juga memiliki metode instalasinya sendiri, tetapi panduan ini hanya membahas instalasi pada komputer biasa.

Jika menginginkan jendela

macOS, Windows

• macOS: buka DMG
• Windows: buka paket instalasi
• Tambahkan aplikasi ke sistem

Jika hanya memerlukan terminal

Linux, macOS, WSL2

• Gunakan satu install.sh
• Di Windows, gunakan install.ps1
• Setelah instalasi, masukkan hermes

Jangan gunakan dahulu

pip, brew, AUR

• Metode instalasi ini tidak didukung secara resmi
• Sulit diperbarui setelah instalasi
• Gunakan salah satu dari dua cara di sebelah kiri

Sebelum memulai, siapkan komputer macOS, Windows, atau Linux, lalu pastikan komputer tersebut dapat membuka terminal dan mengakses GitHub. Jika Anda berencana memasangnya pada drive eksternal, hubungkan drive terlebih dahulu dan pastikan ruang yang tersedia mencukupi.

Instalasi dan peluncuran pertama

Jika Anda menginginkan antarmuka grafis

Buka bagian unduhan di situs Hermes, lalu unduh paket instalasi yang sesuai dengan sistem Anda. Paket tersebut sudah menyertakan lingkungan runtime sehingga Anda tidak perlu melakukan kompilasi langsung di komputer saat pertama kali membukanya.

• macOS: Buka DMG, lalu pindahkan Hermes.app ke “Applications”. DMG adalah format citra instalasi yang umum digunakan di macOS. Paket ini hanya mendukung Apple silicon; Intel Mac tidak termasuk dalam cakupan dukungan.
• Windows: Buka .appinstaller dengan App Installer milik Windows. Paket ini memasang MSIX bertanda tangan, yaitu salah satu jenis paket instalasi aplikasi yang digunakan Windows.
• Linux: Paket desktop hanya tersedia untuk macOS dan Windows. Di Linux, gunakan perintah terminal di bawah ini. Setelah terpasang, Anda dapat menjalankan hermes desktop.

Jika Anda hanya memerlukan terminal

Jika menggunakan Linux, macOS, atau WSL2, jalankan perintah berikut di terminal:

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

Jika menggunakan PowerShell bawaan Windows, jalankan:

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

Penginstal akan mengunduh kode Hermes dan program yang dibutuhkan untuk menjalankannya. Jika proses unduhan terputus, jalankan kembali perintah yang sama. Setelah instalasi selesai, tutup terminal saat ini, buka jendela terminal baru, lalu masukkan:

hermes

Jika prompt Hermes muncul, berarti perintah tersebut sudah dapat digunakan. Selanjutnya, Anda dapat menjalankan hermes doctor. Perintah ini memeriksa instalasi dan memberi tahu komponen apa saja yang masih belum tersedia.

Menempatkan program di drive eksternal

Pada 9 Oktober 2026, Hermes Agent v0.21.6 telah dipasang pada drive eksternal di sebuah Mac. Program berada di /Volumes/AItools/tools/hermes-agent, perintah peluncur berada di ~/.local/bin/hermes, sedangkan konfigurasi dan percakapan tetap disimpan di ~/.hermes.

Jika nama drive Anda berbeda, ubah jalur setelah --dir menjadi folder milik Anda. Drive tersebut harus tetap terhubung saat Hermes dijalankan.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Program

Drive eksternal

• tools/hermes-agent
• Simpan kode di sini

Perintah

~/.local/bin/hermes

• Masukkan hermes di terminal
• Berlaku setelah membuka jendela baru

Konfigurasi dan percakapan

~/.hermes

• config.yaml berada di sini
• Keluar terlebih dahulu sebelum melepas drive

Mendapatkan parameter koneksi dari OmniProxy

Dalam konfigurasi ini, Hermes terhubung ke OmniProxy, bukan langsung ke Grok atau Gemini. Alamat layanan Grok dan Gemini dikonfigurasi di OmniProxy; jangan memasukkannya langsung ke Hermes.

Komputer Anda

Hermes

→

Gateway lokal

OmniProxy

• Akhiri alamat dengan /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Model ID adalah nama persis yang digunakan API untuk mengenali model. Gunakan nama berikut untuk kedua model:

• Untuk Grok, masukkan grok-4.7. Antarmuka xAI berada di https://api.x.ai/v1, sedangkan permintaan percakapan menggunakan /v1/chat/completions. Lihat dokumentasi model Grok.
• Untuk Gemini, masukkan gemini-3.8-flash. Antarmuka kompatibel OpenAI milik Google berada di https://generativelanguage.googleapis.com/v1beta/openai/. Lihat penjelasan kompatibilitas OpenAI untuk Gemini.

Untuk beralih ke Gemini di Hermes, cukup ubah nama model menjadi gemini-3.8-flash. Alamat antarmuka tetap menggunakan alamat OmniProxy.

Salin alamat antarmuka dan kunci dari OmniProxy, lalu masukkan Model ID yang sesuai:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL adalah alamat antarmuka tempat Hermes mengirim permintaan. Dalam konfigurasi ini, alamat tersebut harus diakhiri dengan /v1. API Key adalah kunci yang diberikan OmniProxy kepada Hermes. Ganti dengan nilai milik Anda dan jangan menampilkannya di halaman publik.

Jika OmniProxy lokal tidak memerlukan kunci, API Key dapat dibiarkan kosong. Namun, jika alamatnya dapat diakses oleh orang lain, Anda harus menggunakan kunci. Pastikan juga alamat tersebut dapat diakses dari lingkungan tempat Hermes berjalan. Jika Hermes dan OmniProxy berada di komputer yang sama, Anda dapat menggunakan alamat lokal.

Mengisi konfigurasi alat

Keluar terlebih dahulu dari percakapan yang sedang berlangsung, lalu jalankan perintah berikut di terminal:

hermes model

Pilih Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint adalah antarmuka khusus yang membuat Hermes terhubung ke alamat layanan yang Anda tentukan, bukan menggunakan penyedia yang telah ditetapkan sebelumnya.

Panduan konfigurasi akan menanyakan alamat antarmuka, kunci, dan nama model secara berurutan. Isi ketiganya sesuai bagian sebelumnya. Jika ingin menggunakan Gemini, masukkan gemini-3.8-flash sebagai nama model.

Anda juga dapat langsung mengedit ~/.hermes/config.yaml. YAML adalah format teks yang menggunakan indentasi untuk menunjukkan hubungan antarkonfigurasi. Berikut konfigurasi untuk Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Untuk menggunakan Gemini, ubah default menjadi gemini-3.8-flash. Tiga nilai lainnya tetap sama:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Setelah menyimpan konfigurasi, jalankan kembali hermes, lalu mulai percakapan. Dalam sesi yang sudah terbuka, /model hanya dapat digunakan untuk beralih di antara penyedia yang telah disimpan dan tidak dapat digunakan untuk menambahkan konfigurasi ini.

Memverifikasi tugas nyata

1

hermes doctor

• Pemeriksaan instalasi berhasil

2

Kirim satu kalimat singkat

• Pastikan balasan Hermes terlihat

3

Buka catatan panggilan

• Periksa nama model

1. Jalankan hermes doctor untuk memeriksa apakah instalasi sudah lengkap.
2. Jalankan hermes, lalu minta Hermes menjelaskan dalam satu kalimat apa yang dapat dilakukannya. Anda seharusnya melihat sebuah balasan.
3. Buka catatan pemanggilan OmniProxy, pastikan permintaan tersebut berasal dari Hermes, lalu periksa apakah nama modelnya adalah grok-4.7 atau gemini-3.8-flash.

Hanya melihat bahwa konfigurasi berhasil disimpan oleh panduan atau bahwa antarmuka mengembalikan respons sukses belum membuktikan Hermes dapat menyelesaikan tugas untuk Anda. Nama model dalam catatan pemanggilan harus sama dengan nilai yang dimasukkan.

Untuk melakukan percakapan melalui peramban, jalankan perintah berikut secara lokal:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Kemudian buka http://127.0.0.1:9119. Alamat ini hanya berlaku pada komputer yang sedang digunakan.

Kesalahan umum

• Perintah hermes tidak ditemukan: Tutup terminal, lalu buka jendela terminal baru. Jika masih tidak ditemukan, pastikan ~/.local/bin sudah ada di PATH. PATH adalah daftar lokasi direktori yang digunakan sistem untuk mencari perintah. Di Windows, pastikan direktori peluncuran yang ditambahkan oleh penginstal juga sudah ada di PATH.
• Unduhan instalasi terputus di tengah proses: Jalankan kembali perintah instalasi yang sama. Bagian yang sudah diunduh akan digunakan kembali.
• Hermes tidak membalas atau melaporkan tidak dapat terhubung: Pastikan OmniProxy sedang berjalan dan periksa apakah Base URL diakhiri dengan /v1. Jika Hermes berjalan di dalam Docker sementara OmniProxy berada di komputer host, jangan gunakan 127.0.0.1 yang hanya berlaku di dalam kontainer.
• Muncul pesan bahwa kunci salah: Perbarui kunci OmniProxy, lalu ubah api_key di config.yaml. Kunci xAI atau Google termasuk dalam pengaturan penyedia OmniProxy dan tidak boleh dimasukkan ke kolom Hermes ini.
• Muncul pesan bahwa model tidak tersedia: Buka daftar model OmniProxy saat ini, lalu salin grok-4.7 atau gemini-3.8-flash persis seperti yang ditampilkan dalam daftar.
• Hermes membalas, tetapi tidak dapat membaca berkas, menjalankan perintah, atau melakukan tugas serupa: Gunakan model lain di OmniProxy yang memiliki kemampuan tersebut, lalu mulai sesi Hermes baru.
• Program berada di drive eksternal dan hermes doctor melaporkan kesalahan penyimpanan setelah drive dilepas: Hubungkan kembali drive tersebut terlebih dahulu. Jangan biarkan Hermes membuat rangkaian konfigurasi lain saat drive belum terhubung.

Referensi resmi

Untuk langkah instalasi, lihat dokumentasi instalasi Hermes dan dukungan platform. Untuk konfigurasi Custom endpoint, lihat dokumentasi Hermes Provider. Untuk Model ID, lihat dokumentasi model Grok dan penjelasan kompatibilitas OpenAI untuk Gemini.

Proses instalasi di macOS telah diselesaikan pada 2026-10-09 menggunakan Hermes Agent v0.21.6. grok-4.7 dan gemini-3.8-flash adalah Model ID standar dalam dokumentasi xAI dan Google pada tanggal tersebut. Saat mengisi konfigurasi, gunakan nama yang ditampilkan di OmniProxy.

Ganti setiap placeholder dengan nilai dari konfigurasi OmniProxy Anda sendiri. Jangan pernah menerbitkan kunci asli.

Hasil tersimpan atau HTTP 200 saja tidak membuktikan kompatibilitas Agen penuh. Periksa sumber dan model dalam catatan panggilan OmniProxy.

Sumber resmi · Hermes ↗