Hermes Kurulumu ve OmniProxy Yapılandırması

Hermes, konuşmaları ve görevlerden edinilen deneyimleri saklayabilen bir asistandır. Tamamladığı işleri daha sonra yeniden kullanılabilecek beceriler hâlinde düzenleyebilir. Ayrıca aynı Gateway üzerinden Telegram, Discord, Slack, WhatsApp, Signal ve terminale bağlanabilir. Gateway, mesajları tek bir noktadan alıp yönlendiren bir giriş olarak düşünülebilir. Sık kullandığınız sohbet aracından Hermes’e kod inceleme, olay kaydı veya müşteri materyalleri verebilir, ardından depoya dönerek çalışmaya devam etmesini sağlayabilirsiniz.

Kurulumdan önce hazırlık

Öncelikle bilgisayarınızın işletim sistemine göre bir kurulum yöntemi seçin. macOS ve Windows’ta doğrudan grafik arayüzlü kurulum paketini kullanabilirsiniz. Linux, macOS ve WSL2’de terminal betiği kullanılabilir. WSL2, Windows içinde Linux ortamı çalıştırmaya yarayan bir özelliktir. Android telefonlardaki Termux ve Docker için de ayrı kurulum yöntemleri vardır; bu rehber yalnızca normal bilgisayarlardaki kurulumu ele almaktadır.

Pencere istiyorsanız

macOS, Windows

• macOS: DMG dosyasını açın
• Windows: Kurulum paketini açın
• Uygulamayı sisteme ekleyin

Yalnızca terminal istiyorsanız

Linux, macOS, WSL2

• Tek bir install.sh
• Windows'ta install.ps1 kullanın
• Kurulumdan sonra hermes yazın

Şimdilik kullanmayın

pip, brew, AUR

• Bu kurulum yöntemleri resmi olarak desteklenmez
• Kurulumdan sonra güncellenmeleri de zordur
• Soldaki iki yöntemden birini kullanın

Başlamadan önce macOS, Windows veya Linux çalıştıran bir bilgisayar hazırlayın ve terminali açabildiğini, ayrıca GitHub’a erişebildiğini doğrulayın. Taşınabilir diske kurulum yapacaksanız diski önceden bağlayın ve yeterli boş alana sahip olduğundan emin olun.

Kurulum ve ilk çalıştırma

Grafik arayüz istiyorsanız

Hermes web sitesinin indirme bölümüne gidin ve sisteminize uygun kurulum paketini indirin. Kurulum paketi gerekli çalışma ortamını zaten içerir; ilk açılışta bilgisayarınızda derleme yapmanız gerekmez.

• macOS: DMG dosyasını açın ve Hermes.app uygulamasını “Applications” klasörüne taşıyın. DMG, macOS’ta yaygın olarak kullanılan bir kurulum kalıbı dosyasıdır. Bu kurulum paketi yalnızca Apple çiplerini destekler; Intel Mac modelleri desteklenmez.
• Windows: .appinstaller dosyasını Windows App Installer ile açın. Bu işlem, Windows’un kullandığı uygulama paketi türlerinden biri olan imzalı bir MSIX yükler.
• Linux: Masaüstü kurulum paketi macOS ve Windows içindir. Linux’ta aşağıdaki terminal komutunu kullanın; kurulumdan sonra hermes desktop komutunu çalıştırabilirsiniz.

Yalnızca terminal istiyorsanız

Linux, macOS veya WSL2 kullanıyorsanız terminalde şunu çalıştırın:

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

Windows’un yerleşik PowerShell uygulamasını kullanıyorsanız şunu çalıştırın:

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

Kurulum aracı, Hermes kodunu ve çalışması için gereken programları indirir. İndirme yarıda kesilirse aynı komutu yeniden çalıştırmanız yeterlidir. Kurulum tamamlandıktan sonra mevcut terminali kapatın, yeni bir pencere açın ve şunu girin:

hermes

Hermes istemini görmeniz, komutun artık kullanılabildiği anlamına gelir. Ardından hermes doctor komutunu çalıştırabilirsiniz. Bu komut kurulumu denetler ve hâlâ eksik olan bileşenleri bildirir.

Programı taşınabilir diske kurma

9 Ekim 2026 tarihinde Hermes Agent v0.21.6, bir Mac üzerinde taşınabilir diske kurularak test edilmiştir. Program /Volumes/AItools/tools/hermes-agent konumunda, başlatma komutu ~/.local/bin/hermes konumunda bulunurken yapılandırma ve konuşmalar ~/.hermes içinde tutulmaya devam etmiştir.

Diskinizin adı farklıysa --dir seçeneğinden sonraki yolu kendi klasörünüzle değiştirin. Hermes çalışırken bu disk bağlı kalmalıdır.

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

Program

Harici disk

• tools/hermes-agent
• Kod burada tutulur

Komut

~/.local/bin/hermes

• Terminalde hermes yazın
• Yeni bir pencere açtıktan sonra etkinleşir

Yapılandırma ve konuşmalar

~/.hermes

• config.yaml burada
• Diski çıkarmadan önce uygulamadan çıkın

OmniProxy’den bağlantı bilgilerini alma

Hermes burada doğrudan Grok veya Gemini’ye değil, OmniProxy’ye bağlanır. Grok ve Gemini hizmet adresleri OmniProxy içinde yapılandırılır; bunları doğrudan Hermes’e girmeyin.

Bilgisayarınız

Hermes

→

Yerel ağ geçidi

OmniProxy

• Adres /v1 ile bitmeli

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Model ID, API’nin modeli tanımak için kullandığı tam addır. İki model için aşağıdaki adları kullanın:

• Grok için grok-4.7 girin. xAI API adresi https://api.x.ai/v1, sohbet isteği yolu ise /v1/chat/completions şeklindedir. Bkz. Grok model belgeleri.
• Gemini için gemini-3.8-flash girin. Google’ın OpenAI uyumlu API adresi https://generativelanguage.googleapis.com/v1beta/openai/ şeklindedir. Bkz. Gemini OpenAI uyumluluk açıklaması.

Hermes’te Gemini’ye geçmek istiyorsanız yalnızca model adını gemini-3.8-flash olarak değiştirin; API adresi olarak yine OmniProxy adresini kullanın.

OmniProxy’den API adresini ve anahtarı kopyalayıp ilgili Model ID ile birlikte girin:

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

Base URL, Hermes’in istek göndereceği API adresidir ve burada /v1 ile bitmelidir. API Key, OmniProxy’nin Hermes’e verdiği anahtardır. Bunu kendi anahtarınızla değiştirin ve herkese açık bir sayfada paylaşmayın.

Yerel OmniProxy anahtar istemiyorsa API Key alanını boş bırakabilirsiniz. Adrese başka kişiler erişebiliyorsa anahtar kullanılmalıdır. Ayrıca bu adresin Hermes’in çalıştığı ortamdan erişilebilir olduğunu doğrulayın. Hermes ve OmniProxy aynı bilgisayarda çalışıyorsa yerel adres kullanabilirsiniz.

Araç yapılandırmasını girme

Önce devam eden sohbetten çıkın, ardından terminalde şunu çalıştırın:

hermes model

Custom endpoint (self-hosted / VLLM / etc.) seçeneğini seçin. Custom endpoint, Hermes’in önceden tanımlanmış bir sağlayıcı yerine belirttiğiniz hizmet adresine bağlanmasını sağlayan özel uç noktadır.

Sihirbaz sırasıyla API adresini, anahtarı ve model adını soracaktır. Önceki bölümdeki üç değeri girin. Gemini kullanmak istiyorsanız model adı olarak gemini-3.8-flash girin.

Alternatif olarak ~/.hermes/config.yaml dosyasını doğrudan düzenleyebilirsiniz. YAML, yapılandırma ilişkilerini girintilerle gösteren bir metin biçimidir. Grok yapılandırması aşağıdaki gibidir:

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

Gemini kullanırken default değerini gemini-3.8-flash olarak değiştirin; diğer üç alanı değiştirmeyin:

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

Dosyayı kaydettikten sonra hermes komutunu yeniden çalıştırın ve yeni bir sohbet başlatın. Açık olan bir oturumda /model yalnızca önceden kaydedilmiş sağlayıcılar arasında geçiş yapabilir; bu yeni yapılandırmayı eklemek için kullanılamaz.

Gerçek bir görevle doğrulama

1

hermes doctor

• Kurulum denetimi başarılı

2

Kısa bir cümle gönderin

• Hermes'in yanıtını görün

3

Çağrı kayıtlarını açın

• Model adını doğrulayın

1. Kurulumun eksiksiz olup olmadığını kontrol etmek için hermes doctor komutunu çalıştırın.
2. hermes komutunu çalıştırın ve neler yapabildiğini tek cümleyle açıklamasını isteyin. Bir yanıt görmelisiniz.
3. OmniProxy çağrı kayıtlarını açın, isteğin Hermes’ten geldiğini doğrulayın ve model adının grok-4.7 veya gemini-3.8-flash olup olmadığını kontrol edin.

Yalnızca sihirbazın yapılandırmayı başarıyla kaydettiğini veya API’nin başarılı yanıt verdiğini görmek, Hermes’in sizin için görev tamamlayabildiği anlamına gelmez. Çağrı kaydındaki model adı, girdiğiniz değerle aynı olmalıdır.

Tarayıcıda sohbet etmek istiyorsanız yerel bilgisayarınızda şunu çalıştırın:

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

Ardından http://127.0.0.1:9119 adresini açın. Bu adres yalnızca mevcut bilgisayarda geçerlidir.

Yaygın hatalar

• hermes yazdığınızda komutun bulunamadığı belirtiliyorsa önce terminali kapatıp yeni bir pencere açın. Komut hâlâ bulunamıyorsa ~/.local/bin dizininin PATH içinde olduğunu doğrulayın. PATH, sistemin komutların bulunduğu dizinleri aramak için kullandığı konum listesidir. Windows’ta ise kurulum aracının eklediği başlatma dizininin PATH içinde olduğunu doğrulayın.
• Kurulum indirmesi yarıda kesilirse aynı kurulum komutunu yeniden çalıştırın; daha önce indirilen bölümler kullanılmaya devam eder.
• Hermes yanıt vermiyorsa veya bağlantı kurulamadığını belirtiyorsa OmniProxy’nin çalıştığını doğrulayın ve Base URL’nin /v1 ile bitip bitmediğini kontrol edin. Hermes Docker içinde, OmniProxy ise ana sistemde çalışıyorsa yalnızca kapsayıcı içinde geçerli olan 127.0.0.1 adresini kullanmayın.
• Anahtar hatası gösteriliyorsa OmniProxy anahtarını güncelleyin ve ardından config.yaml içindeki api_key değerini değiştirin. xAI veya Google anahtarı, OmniProxy’nin sağlayıcı ayarlarına aittir; Hermes’teki bu alana girmeyin.
• Modelin bulunmadığı belirtiliyorsa OmniProxy’nin güncel model listesini açın ve grok-4.7 veya gemini-3.8-flash adını listede göründüğü biçimiyle aynen kopyalayın.
• Yanıt veriyor ancak dosya okuma veya komut çalıştırma gibi işlemleri yapamıyorsa OmniProxy’de bu yeteneklere sahip başka bir modele geçin ve yeni bir Hermes oturumu başlatın.
• Program taşınabilir diskteyken diski çıkardıktan sonra hermes doctor depolama hatası veriyorsa önce diski yeniden bağlayın. Disk bağlı değilken Hermes’in ayrı bir yapılandırma oluşturmasına izin vermeyin.

Resmî başvuru kaynakları

Kurulum adımları için Hermes kurulum belgelerine ve platform desteği belgelerine bakın. Custom endpoint yapılandırması için Hermes Provider belgelerine bakın. Model ID bilgileri için sırasıyla Grok model belgelerine ve Gemini OpenAI uyumluluk açıklamasına bakın.

macOS kurulumu, 2026-10-09 tarihinde Hermes Agent v0.21.6 kullanılarak baştan sona tamamlanmıştır. grok-4.7 ve gemini-3.8-flash, o tarihte xAI ve Google belgelerinde yer alan standart model ID’leriydi. Gerçek yapılandırmayı yaparken OmniProxy’de gösterilen adı esas alın.

Tüm yer tutucuları kendi OmniProxy yapılandırmanızdaki değerlerle değiştirin. Gerçek bir anahtar asla paylaşmayın.

Kaydedilmiş bir sonuç veya yalnızca HTTP 200, tam Aracı uyumluluğunu kanıtlamaz. OmniProxy'nin çağrı kaydındaki kaynağı ve modeli kontrol edin.

Resmi kaynaklar · Hermes ↗