Pemasangan Hermes dan Konfigurasi OmniProxy

Hermes ialah pembantu yang boleh menyimpan pengalaman perbualan dan tugasan, serta menyusun perkara yang pernah dilakukan menjadi kemahiran untuk digunakan semula. Ia juga boleh menyambung kepada Telegram, Discord, Slack, WhatsApp, Signal dan terminal melalui Gateway yang sama; Gateway boleh dianggap sebagai pintu masuk bersepadu untuk menerima dan menghantar semula mesej. Anda boleh memberikan semakan kod, catatan insiden atau bahan pelanggan kepadanya melalui aplikasi sembang yang biasa digunakan, kemudian memintanya kembali ke repositori untuk meneruskan kerja.

Persediaan sebelum pemasangan

Pilih kaedah pemasangan berdasarkan sistem komputer anda. macOS dan Windows boleh menggunakan pakej pemasangan dengan antara muka tetingkap secara terus; Linux, macOS dan WSL2 boleh menggunakan skrip terminal. WSL2 ialah fungsi untuk menjalankan persekitaran Linux dalam Windows. Termux pada telefon Android dan Docker juga mempunyai kaedah pemasangan masing-masing, tetapi panduan ini hanya menerangkan pemasangan pada komputer biasa.

Mahukan tetingkap

macOS, Windows

• macOS: buka DMG
• Windows: buka pakej pemasangan
• Letakkan aplikasi dalam sistem

Hanya perlukan terminal

Linux, macOS, WSL2

• Satu perintah install.sh
• Gunakan install.ps1 pada Windows
• Taip hermes selepas pemasangan

Jangan gunakan dahulu

pip, brew, AUR

• Kaedah pemasangan ini tidak disokong secara rasmi
• Sukar dikemas kini walaupun selepas dipasang
• Gunakan salah satu daripada dua kaedah di sebelah kiri

Sebelum bermula, sediakan komputer macOS, Windows atau Linux, kemudian pastikan komputer itu boleh membuka terminal dan mengakses GitHub. Jika anda mahu memasang pada pemacu keras mudah alih, sambungkan pemacu itu terlebih dahulu dan pastikan ruangnya mencukupi.

Pasang dan jalankan buat kali pertama

Jika anda mahukan antara muka tetingkap

Pergi ke bahagian muat turun laman web Hermes, kemudian muat turun pakej pemasangan yang sepadan dengan sistem anda. Pakej pemasangan sudah menyertakan persekitaran masa jalan, jadi anda tidak perlu mengkompilnya pada komputer semasa membukanya buat kali pertama.

• macOS: Buka DMG dan letakkan Hermes.app dalam “Applications”. DMG ialah fail imej pemasangan yang biasa digunakan pada macOS. Pakej pemasangan ini hanya menyokong cip Apple; Intel Mac tidak disokong.
• Windows: Buka .appinstaller menggunakan pemasang aplikasi Windows. Ia akan memasang MSIX bertandatangan, iaitu sejenis pakej pemasangan aplikasi yang digunakan oleh Windows.
• Linux: Pakej pemasangan desktop disediakan untuk macOS dan Windows. Untuk Linux, gunakan arahan terminal di bawah. Selepas pemasangan, anda boleh menjalankan hermes desktop.

Jika anda hanya memerlukan terminal

Jika anda menggunakan Linux, macOS atau WSL2, jalankan arahan berikut dalam terminal:

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

Jika anda menggunakan PowerShell terbina dalam Windows, jalankan:

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

Pemasang akan memuat turun kod Hermes dan program yang diperlukan untuk menjalankannya. Jika muat turun terputus di tengah jalan, jalankan semula arahan yang sama. Selepas pemasangan selesai, tutup terminal semasa, buka tetingkap terminal baharu dan masukkan:

hermes

Jika gesaan Hermes dipaparkan, arahan itu sudah boleh digunakan. Seterusnya, anda boleh menjalankan hermes doctor; ini ialah pemeriksaan pemasangan yang akan memberitahu anda perkara yang masih belum tersedia.

Letakkan program pada pemacu keras mudah alih

Pada 9 Oktober 2026, Hermes Agent v0.21.6 telah dipasang pada pemacu keras mudah alih di sebuah Mac. Program berada di /Volumes/AItools/tools/hermes-agent, arahan pelancaran berada di ~/.local/bin/hermes, manakala konfigurasi dan perbualan masih disimpan di ~/.hermes.

Jika nama pemacu keras anda berbeza, tukar laluan selepas --dir kepada folder anda sendiri. Pemacu keras ini mesti kekal disambungkan semasa 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

Pemacu keras luaran

• tools/hermes-agent
• Letakkan kod di sini

Perintah

~/.local/bin/hermes

• Taip hermes dalam terminal
• Berkuat kuasa selepas membuka tetingkap baharu

Konfigurasi dan perbualan

~/.hermes

• config.yaml berada di sini
• Keluar dahulu sebelum mencabut pemacu keras

Dapatkan parameter sambungan daripada OmniProxy

Dalam konfigurasi ini, Hermes menyambung kepada OmniProxy dan bukannya terus kepada Grok atau Gemini. Alamat perkhidmatan Grok dan Gemini dikonfigurasi dalam OmniProxy; jangan masukkannya terus ke dalam Hermes.

Komputer anda

Hermes

→

Get laluan setempat

OmniProxy

• Akhiri alamat dengan /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID model ialah nama tepat yang digunakan oleh antara muka untuk mengenal pasti model. Gunakan nama berikut untuk kedua-dua model:

• Untuk Grok, masukkan grok-4.7. Antara muka xAI ialah https://api.x.ai/v1, dan permintaan sembang menggunakan /v1/chat/completions. Lihat dokumentasi model Grok.
• Untuk Gemini, masukkan gemini-3.8-flash. Antara muka serasi OpenAI daripada Google ialah https://generativelanguage.googleapis.com/v1beta/openai/. Lihat penerangan keserasian OpenAI untuk Gemini.

Jika anda mahu menukar Hermes kepada Gemini, hanya tukar nama model kepada gemini-3.8-flash; alamat antara muka masih perlu menggunakan alamat OmniProxy.

Salin alamat antara muka dan kunci daripada OmniProxy, kemudian masukkan ID model yang berkenaan:

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

Base URL ialah alamat antara muka yang menerima permintaan daripada Hermes dan mestilah berakhir dengan /v1 dalam konfigurasi ini. API Key ialah kunci yang dikeluarkan oleh OmniProxy kepada Hermes. Gantikannya dengan nilai anda sendiri dan jangan letakkannya pada halaman awam.

Jika OmniProxy setempat tidak memerlukan kunci, API Key boleh dibiarkan kosong; jika alamat itu boleh dicapai oleh orang lain, anda perlu menetapkan kunci. Pastikan juga alamat tersebut boleh dicapai daripada persekitaran tempat Hermes dijalankan. Jika Hermes dan OmniProxy berada pada komputer yang sama, anda boleh menggunakan alamat setempat.

Masukkan konfigurasi alat

Keluar dahulu daripada sesi sembang yang sedang berlangsung, kemudian jalankan arahan berikut dalam terminal:

hermes model

Pilih Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint ialah antara muka tersuai yang membolehkan Hermes menyambung kepada alamat perkhidmatan yang anda tentukan dan bukannya menggunakan penyedia pratetap.

Wizard akan meminta alamat antara muka, kunci dan nama model secara berturutan. Masukkan tiga nilai daripada bahagian sebelumnya. Jika anda mahu menggunakan Gemini, masukkan gemini-3.8-flash sebagai nama model.

Anda juga boleh mengedit ~/.hermes/config.yaml secara terus. YAML ialah format teks yang menggunakan inden untuk menunjukkan hubungan konfigurasi. Berikut ialah 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, tukar default kepada gemini-3.8-flash dan biarkan tiga item lain tanpa perubahan:

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

Selepas menyimpan fail, jalankan semula hermes, kemudian mulakan sembang. Dalam sesi yang sudah dibuka, /model hanya boleh bertukar antara penyedia yang telah disimpan dan tidak boleh digunakan untuk menambahkan konfigurasi ini.

Sahkan dengan tugasan sebenar

1

hermes doctor

• Pemeriksaan pemasangan berjaya

2

Hantar ayat ringkas

• Respons Hermes dipaparkan

3

Buka rekod panggilan

• Semak nama model

1. Jalankan hermes doctor untuk memeriksa sama ada pemasangan lengkap.
2. Jalankan hermes, kemudian minta ia menerangkan perkara yang boleh dilakukannya dalam satu ayat. Anda sepatutnya melihat satu balasan.
3. Buka rekod panggilan OmniProxy, sahkan permintaan ini datang daripada Hermes dan periksa sama ada nama model ialah grok-4.7 atau gemini-3.8-flash.

Melihat wizard berjaya menyimpan konfigurasi atau antara muka mengembalikan status berjaya sahaja belum membuktikan bahawa Hermes boleh menyelesaikan tugasan untuk anda. Nama model dalam rekod panggilan mestilah sama dengan nilai yang dimasukkan.

Jika anda mahu bersembang dalam pelayar, jalankan arahan berikut pada komputer setempat:

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

Kemudian buka http://127.0.0.1:9119. Alamat ini hanya boleh digunakan pada komputer semasa.

Ralat lazim

• Jika arahan hermes tidak ditemui: Tutup terminal dahulu, kemudian buka tetingkap baharu. Jika masih tidak ditemui, pastikan ~/.local/bin berada dalam PATH; PATH ialah senarai lokasi direktori yang digunakan oleh sistem untuk mencari arahan. Pada Windows, pastikan direktori pelancaran yang ditambahkan oleh pemasang berada dalam PATH.
• Jika sambungan terputus semasa pemasangan sedang memuat turun: Jalankan semula arahan pemasangan yang sama; bahagian yang sudah dimuat turun akan terus digunakan.
• Jika Hermes tidak membalas atau memaklumkan bahawa sambungan gagal: Pastikan OmniProxy sedang berjalan dan periksa sama ada Base URL berakhir dengan /v1. Jika Hermes berjalan dalam Docker manakala OmniProxy berada pada hos, jangan gunakan 127.0.0.1 yang hanya sah dalam bekas.
• Jika ralat kunci dipaparkan: Kemas kini kunci OmniProxy, kemudian ubah api_key dalam config.yaml. Kunci xAI atau Google ialah sebahagian daripada tetapan penyedia OmniProxy dan tidak boleh dimasukkan dalam ruangan Hermes ini.
• Jika sistem memaklumkan bahawa model tidak tersedia: Buka senarai model semasa dalam OmniProxy, kemudian salin grok-4.7 atau gemini-3.8-flash tepat seperti yang dipaparkan dalam senarai.
• Jika Hermes membalas tetapi tidak boleh membaca fail, menjalankan arahan atau melakukan tugas seumpamanya: Tukar kepada model lain dalam OmniProxy yang mempunyai keupayaan tersebut, kemudian mulakan sesi Hermes baharu.
• Jika program berada pada pemacu keras mudah alih dan hermes doctor melaporkan ralat storan selepas pemacu dicabut: Sambungkan semula pemacu keras itu terlebih dahulu. Jangan biarkan Hermes menulis set konfigurasi lain ketika pemacu tidak disambungkan.

Rujukan rasmi

Untuk langkah pemasangan, lihat dokumentasi pemasangan Hermes dan sokongan platform. Untuk konfigurasi Custom endpoint, lihat dokumentasi Hermes Provider. Untuk ID model, lihat dokumentasi model Grok dan penerangan keserasian OpenAI untuk Gemini.

Pemasangan pada macOS telah dilengkapkan pada 2026-10-09 menggunakan Hermes Agent v0.21.6. grok-4.7 dan gemini-3.8-flash ialah ID model standard dalam dokumentasi xAI dan Google pada tarikh tersebut. Semasa memasukkan nilai sebenar, gunakan nama yang dipaparkan dalam OmniProxy.

Gantikan setiap penanda tempat dengan nilai dari konfigurasi OmniProxy anda sendiri. Jangan pernah terbitkan kunci sebenar.

Hasil tersimpan atau HTTP 200 sahaja tidak membuktikan keserasian Agen penuh. Semak sumber dan model dalam rekod panggilan OmniProxy.

Sumber rasmi · Hermes ↗