Hermes Agent, Nous Research'ün 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 açık kaynaklı bir AI Agent'tır. Bu kılavuz Hermes'i nasıl kuracağınızı öğrenmenize yardımcı olur. macOS veya Windows için standart yükleyicide Python veya Node.js'i elle kurmanıza gerek yoktur, çünkü resmi yükleyici temel bağımlılıkları sizin için halleder.
Hermes Agent'ı Kurmadan Önce
Hermes Agent terminal öncelikli bir yazılımdır, bu yüzden onu bir komut satırından kuracaksınız. Bilgisayarınıza uygun bölümü seçin:
macOS: Terminal'i Applications > Utilities > Terminal yolundan açın veya Command + Space tuşlarına basıp "Terminal" araması yapın.
Windows: Önce WSL2'yi kurun, Linux dağıtımınızın terminalini açın, ardından Linux komutunu izleyin.
Ayrıca Git'e de ihtiyacınız var. Git'in kurulu olup olmadığını kontrol edin:
Beklenen çıktı:
git: command not found görürseniz, önce Git'i kurun:
macOS'te Homebrew'unuz yoksa, aşağıdaki komutu çalıştırarak Git'i Apple Command Line Tools üzerinden kurun:
Adım 1: macOS veya Windows'ta Hermes Agent'ı Kurun
Terminalinizde, resmi yükleyici komutunu kopyalayıp yapıştırın:
Yükleyici Hermes Agent'ı indirir, Python ortamını hazırlar, gerekli bağımlılıkları kurar ve hermes komutunu shell yolunuza ekler. Normal bir kullanıcı kurulumunda Hermes verileri ~/.hermes/ altında saklanır.
Komut tamamlandığında, shell'inizi yeniden yükleyin:
macOS'te yaygın olan Zsh 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.
Adım 2: Model Sağlayıcınızı Yapılandırın
Hermes Agent, yanıt verebilmesi veya araçları kullanabilmesi için önce bir model sağlayıcısına ihtiyaç duyar. Başlangıç için en kolay kurulum etkileşimli olanıdır:
Sihirbaz, Kimi/Moonshot gibi bir sağlayıcı seçmenize olanak tanır. Temel bir sohbet çalışana kadar yönlendirme, yedekleme, ağ geçidi veya cron yapılandırması yapmayın.
Varsayılan modeli seçin. kimi-k2.6, Kimi'nin şimdiye kadarki en gelişmiş modelidir.
Ayarlamak istediğiniz değeri zaten biliyorsanız hermes config set komutunu kullanabilirsiniz. Örneğin:
API anahtarınız yoksa Kimi iyi bir seçim olabilir.
Adım 1: Kimi API'nizi Etkinleştirin
Hermes Agent ile Kimi API'yi kullanmadan önce, Kimi Açık Platform üzerinden Kimi API Anahtarınızı etkinleştirin. Gecikmeyi azaltan ve karmaşık, çok adımlı görevler için daha kararlı performans sağlayan Tier 2 erişimini açmak için en az 20 dolar yüklemenizi öneririz.
Adım 2: Kimi API Anahtarınızı Oluşturun
Kimi Açık Platform'da API Keys bölümüne gidin ve Create API Key'e tıklayın. API anahtarınızı kopyalamayı ve güvenli bir şekilde saklamayı unutmayın, çünkü anahtar yalnızca oluşturulduğunda bir kez gösterilir.
Adım 3: API Anahtarınızı Girin
Kimi API anahtarınızı yapıştırın ve Hermes Agent'a bağlanın.
Adım 3: Hermes Agent'ı Başlatın
Model yapılandırıldıktan sonra, klasik CLI'yi başlatın:
Veya 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ı kurulum şöyle görünür:
Hermes Agent açılıyor ama 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ı veya OAuth girişini doğrulayın.
Adım 4: Hermes Agent'ı Bot Haline Getirme
OpenClaw gibi, Hermes Agent da bir bot olarak çalışıp 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üklememiştir.
Çözüm:
Veya:
Ardından şunu deneyin:
git: command not found
Neden: Git yüklü değil.
Ubuntu, Debian veya WSL2'de çözüm:
Homebrew ile macOS'ta çözüm:
API Anahtarı Ayarlanmamış
Neden: Hermes Agent kurulu, ancak herhangi bir sağlayıcı anahtarı veya girişi yapılandırılmamış.
Çözüm:
Veya bir anahtarı manuel olarak ayarlayın:
hermes doctor Eksik veya Güncel Olmayan Yapılandırma Bildiriyor
Neden: bir güncellemeden sonra yapılandırma dosyanız eksik kalmış olabilir.
Çözüm:
Özel Uç Nokta Bağlanıyor Ama Kötü Yanıtlar Veriyor
Neden: temel URL, model adı veya bağlam uzunluğu yanlış.
Çözüm: uç noktayı önce 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 Referansı
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 ile doğrulamaktır. İlk kurulumunuzu basit tutun: tek makine, tek sağlayıcı, tek çalışan konuşma. Temel Hermes Agent asistanı kararlı hale geldikten sonra, Docker izolasyonu, gateway botları, beceriler, zamanlanmış otomasyonlar ve özel model sağlayıcılarıyla güvenle üzerine inşa edebilirsiniz.
SSS
~/.hermes/ altında saklar ve becerilerle, bellekle, zamanlanmış görevlerle ve mesajlaşma ağ geçitleriyle genişletilebilir.hermes model komutunu çalıştırın, Kimi gibi bir sağlayıcı seçin, hermesi başlatın, normal bir sohbeti test edin, hermes doctor komutunu çalıştırın ve hermes --continue komutunun oturumunuzu devam ettirdiğini doğrulayın. Bundan sonra ihtiyaç duydukça Docker izolasyonu, beceriler, MCP sunucuları, ses, cron veya bir mesajlaşma ağ geçidi ekleyin.