Hermes Agent; terminalinizden çalışan, farklı model sağlayıcılarına bağlanan, oturumlar arasında yararlı bağlamı hatırlayan ve araçlar, beceriler, mesajlaşma ağ geçitleri ile otomasyonla genişletilebilen, Nous Research tarafından geliştirilen açık kaynaklı bir AI ajanıdır. Bu rehber, Hermes’i nasıl yükleyeceğinizi anlamanıza yardımcı olur. Resmî yükleyici temel bağımlılıkları sizin için yönettiğinden, macOS veya Windows’ta standart yükleyici için Python ya da Node.js’yi manuel olarak yüklemeniz gerekmez.
Hermes Agent’ı Yüklemeden Önce
Hermes Agent terminal odaklı bir yazılımdır; bu nedenle komut satırından yükleyeceksiniz. Bilgisayarınıza uygun bölümü seçin:
macOS: Uygulamalar > İzlenceler > Terminal yolundan Terminal’i açın veya Command + Space tuşlarına basıp "Terminal" araması yapın.
Windows: Önce WSL2’yi yükleyin, Linux dağıtımınızın terminalini açın, ardından Linux komutunu uygulayın.
Ayrıca Git’e de ihtiyacınız var. Git’in yüklü olup olmadığını kontrol edin:
Beklenen çıktı:
git: command not found mesajını görürseniz önce Git’i yükleyin:
macOS’ta Homebrew yüklü değilse şu komutu çalıştırarak Apple Command Line Tools üzerinden Git’i yükleyin:
1. Adım: Hermes Agent’ı macOS veya Windows’a Yükleme
Terminalinizde resmî yükleyici komutunu kopyalayıp yapıştırın:
Yükleyici Hermes Agent’ı indirir, Python ortamını hazırlar, gerekli bağımlılıkları yükler ve hermes komutunu kabuk yolunuza ekler. Normal bir kullanıcı yüklemesinde Hermes verileri ~/.hermes/ altında depolanır.
Komut tamamlandığında kabuğunuzu yeniden yükleyin:
macOS’ta yaygın olarak kullanılan Zsh’yi kullanıyorsanız şunu çalıştırın:
Beklenen sonuç:
Şimdi Hermes Agent komutunun kullanılabilir olduğunu doğrulayın:
Beklenen sonuç:
Hermes Agent güncellendikçe tam sürüm numarası değişebilir.
2. Adım: Model Sağlayıcınızı Yapılandırma
Hermes Agent’ın yanıt verebilmesi veya araçları kullanabilmesi için bir model sağlayıcısına ihtiyacı vardır. Yeni başlayanlar için en kolay kurulum etkileşimli yapılandırmadır:
Sihirbaz, Kimi/Moonshot gibi bir sağlayıcı seçmenizi sağlar. Temel bir sohbet çalışana kadar yönlendirme, geri dönüş, ağ geçidi veya cron yapılandırmayın.
Varsayılan modeli seçin. Kimi K3, Kimi’nin en yeni amiral gemisi modelidir; ağırlıklı olarak kodlama için kullanacaksanız kimi-k2.7-code daha iyi bir seçimdir.
Ayarlamak istediğiniz değeri zaten biliyorsanız hermes config set komutunu kullanabilirsiniz. Örneğin:
Bir API anahtarınız yoksa Kimi iyi bir seçenek olabilir.
1. Adım: Kimi API’nizi Etkinleştirin
Kimi API’yi Hermes Agent ile kullanmadan önce Kimi Platform üzerinden Kimi API Key’inizi etkinleştirin. Gecikmeyi azaltan ve karmaşık, çok adımlı görevlerde daha istikrarlı performans sağlayan Tier 2 erişiminin kilidini açmak için 20 $ ve üzerini öneriyoruz.
2. Adım: Kimi API Key’inizi Oluşturun
Kimi Platform’daki API Keys bölümüne gidin ve Create API Key’e tıklayın. API anahtarınızı kopyalayıp güvenli bir yerde saklamayı unutmayın. Anahtar yalnızca oluşturulurken gösterilir.
3. Adım: API anahtarınızı girin
Kimi API anahtarınızı yapıştırın ve Hermes Agent’ı bağlayın.
3. Adım: Hermes Agent’ı Başlatın
Model yapılandırıldıktan sonra klasik CLI'yi başlatın:
Ya da daha yeni terminal arayüzünü deneyin:
Seçtiğiniz sağlayıcıyı/modeli gösteren bir karşılama ekranı veya prompt görmelisiniz. Basit bir istekle test edin:
Başarılı bir kurulum şöyle görünür:
Hermes Agent açılıyor ancak model veya kimlik doğrulama hatalarıyla yanıt veriyorsa şunu çalıştırın:
Ardından sağlayıcınızı yeniden seçin ve API anahtarını ya da OAuth oturum açma bilgilerini doğrulayın.
4. Adım: Hermes Agent'ı Bota Dönüştürme
OpenClaw gibi Hermes Agent da bot olarak çalışabilir ve sohbet uygulamalarınıza bağlanabilir:
Kurulumdan sonra gateway durumunu kontrol edin:
Gateway'i yalnızca model sağlayıcınız terminalde çalıştıktan sonra kullanın. CLI temel bir sohbeti tamamlayamıyorsa bot da genellikle aynı nedenle başarısız olur.
Yaygın Hermes Agent Kurulum Sorunları
hermes: command not found
Neden: Terminaliniz PATH değişikliğini henüz yeniden yüklemedi.
Çözüm:
Veya:
Ardından şunu deneyin:
git: command not found
Neden: Git yüklü değil.
Ubuntu, Debian veya WSL2 için çözüm:
Homebrew kullanan macOS için çözüm:
API Anahtarı Ayarlanmamış
Neden: Hermes Agent yüklü, ancak sağlayıcı anahtarı veya oturum açma yapılandırılmamış.
Çözüm:
Ya da anahtarı manuel olarak ayarlayın:
hermes doctor Eksik veya Güncel Olmayan Yapılandırma Bildiriyor
Neden: Yapılandırma dosyanız bir güncellemeden sonra eksik kalmış olabilir.
Çözüm:
Özel Uç Nokta Bağlanıyor Ancak Hatalı Yanıtlar Veriyor
Neden: Temel URL, model adı veya bağlam uzunluğu yanlış.
Çözüm: Önce uç noktayı ayrı bir istemcide test edin, OpenAI uyumlu olduğunu doğrulayın ve modelin normal Hermes Agent iş akışları için en az 64K bağlamı desteklediğinden emin olun.
Hızlı Komut Başvurusu
Sonuç
Hermes Agent'ı kurmanın en kolay yolu, resmi tek satırlık yükleyiciyi kullanmak, kabuğunuzu yeniden yüklemek, hermes model komutunu çalıştırmak ve kurulumu gerçek bir sohbetle birlikte hermes doctor kullanarak doğrulamaktır. İlk kurulumunuzu basit tutun: tek makine, tek sağlayıcı, çalışan tek bir sohbet. Temel Hermes Agent asistanı kararlı hâle geldiğinde Docker yalıtımı, gateway botları, beceriler, zamanlanmış otomasyonlar ve özel model sağlayıcılarıyla güvenle geliştirebilirsiniz.
SSS
~/.hermes/ altında saklar ve beceriler, bellek, zamanlanmış işler ve mesajlaşma ağ geçitleriyle genişletilebilir.iex (irm https://hermes-agent.nousresearch.com/install.ps1) ile kurulum yapabilir veya MSIX masaüstü paketini kullanabilirsiniz. WSL2 isteğe bağlı bir alternatif olmaya devam eder.hermes model komutunu çalıştırın, Kimi gibi bir sağlayıcı seçin, hermes komutunu başlatın, normal bir sohbeti test edin, hermes doctor komutunu çalıştırın ve hermes --continue komutunun oturumunuzu sürdürdüğünü doğrulayın. Ardından ihtiyacınıza göre Docker yalıtımı, beceriler, MCP sunucuları, ses, cron veya bir mesajlaşma ağ geçidi ekleyin.