Hermes API Entegrasyonu:
Eksiksiz Kurulum Kılavuzu ve Çalışma Mantığı

Hermes API nedir?

Hermes API, Hermes Agent’ın AI modellerine ve araçlarına bağlanmasını sağlayan temel arayüzüdür. agent’ın Kimi gibi model sağlayıcılarına nasıl istek gönderdiğini, verileri nasıl yönlendirdiğini ve yanıtları nasıl aldığını yönetir. Hermes API sayesinde kullanıcılar agent’ı iş akışlarını otomatikleştirecek, çok adımlı görevleri çalıştıracak ve karmaşık süreçleri elle müdahale etmeden yönetecek şekilde yapılandırabilir.

Hermes API Kimi ile nasıl kurulur?

Hermes API, OpenAI uyumlu arayüzü üzerinden Moonshot AI’ın Kimi API’si de dâhil olmak üzere birden fazla model sağlayıcıyı destekler. Bu sayede mevcut kurulumunuzu değiştirmeden sağlayıcılar arasında geçiş yapabilirsiniz. Aşağıdaki adımlar, Hermes API’yi model sağlayıcınız olarak Kimi’yi kullanacak şekilde yapılandırmanızda size yol gösterir.

1. Adım: Hermes Agent’ı yükleyin

Öncelikle resmi kurulum betiğini kullanarak Hermes Agent’ı yükleyin:

Kurulumdan sonra bir sonraki adım, terminalinizde gösterilen çıktıya bağlıdır.

OpenClaw içe aktarma istemini görürseniz

Hermes mevcut bir OpenClaw kurulumu algıladı. Geçerli çalışma alanınızı, becerilerinizi ve agent ayarlarınızı içe aktarmak için Y yazıp Enter’a basın. İçe aktarma tamamlandığında kurulum sihirbazına devam edebilirsiniz.

OpenClaw’dan içe aktarma yapıp yapmamaya karar vermek için y veya N tuşuna basın.

OpenClaw içe aktarma istemini görmüyorsanız

Kurulumdan sonra yeni komutların etkinleşmesi için kabuğunuzu yenileyin. Bu adımı atlamak, Hermes’i çalıştırırken "command not found" hatalarına yol açabilir.

Kullandığınız kabuğa göre aşağıdaki komutlardan birini kullanın.

Bash kullanıyorsanız:

Zsh kullanıyorsanız:

2. Adım: Sağlayıcı ve model seçin

Kurulum sırasında model sağlayıcınızı seçin; Kimi/Moonshot desteklenir. Hermes zaten yüklüyse şunu çalıştırın

Varsayılan modeli seçin. kimi-k2.6, Kimi’nin bugüne kadarki en gelişmiş modelidir.

3. Adım: Kimi API’nizi etkinleştirin

Kimi API’yi Hermes Agent ile kullanmadan önce Kimi Açık Platform üzerinde Kimi API Anahtarınızı etkinleştirin. Gecikmeyi azaltan ve karmaşık, çok adımlı görevlerde daha kararlı performans sunan Tier 2 erişimini açmak için 20 ABD doları ve üzerini öneririz

4. Adım: Kimi API Anahtarınızı oluşturun

Kimi Açık Platform’daki API Keys bölümüne gidin ve Create API Key. seçeneğine tıklayın. API anahtarınızı kopyalayıp güvenli bir yerde saklamayı unutmayın. Çünkü anahtar yalnızca oluşturulduğu anda bir kez gösterilir

5. Adım: API anahtarınızı girin

Kimi API anahtarınızı yapıştırın ve Hermes Agent’ı bağlayın.

6. Adım: Bir mesajlaşma platformu kurun

Bir mesajlaşma platformu seçin; emin değilseniz bu adımı atlayın.

7. Adım: Sohbeti başlatmak için Y girin

Hermes Agent’ınızı başlatın.

8. Adım: Hermes’i ilk kez başlatın

Hermes Agent ile sohbet etmek istiyorsanız şunu çalıştırabilirsiniz:

veya daha iyi bir arayüz için:

9. Adım: İlk görevinizi çalıştırın

Hermes Agent’ınıza bir talimat göndermeyi deneyin.

Örnek:

Yaygın Hermes Agent API entegrasyon hataları ve çözümleri

Hermes Agent bir model sağlayıcıyla entegre edilirken hataların çoğu yanlış yapılandırılmış API anahtarlarından, hatalı model tanımlayıcılarından veya sağlayıcıya özgü sınırlamalardan kaynaklanır. En sık karşılaşılan sorunlar ve çözümleri aşağıdadır.

/model yalnızca tek sağlayıcı gösteriyor / sağlayıcı değiştirilemiyor

• Neden: /model komutu yalnızca daha önce yapılandırılmış sağlayıcıları listeler.

• Çözüm: Yeni sağlayıcılar eklemek için mevcut oturumunuzdan çıkın ve terminalinizden hermes model çalıştırın.

API anahtarı çalışmıyor

• Neden: Anahtar eksik, süresi dolmuş, yanlış ayarlanmış veya yanlış sağlayıcıya ait olabilir.

• Çözüm:

Model kullanılamıyor / model bulunamadı

• Neden: Model tanımlayıcısı hatalı olabilir veya mevcut sağlayıcınızda kullanılamıyor olabilir.

• Çözüm:

Hız sınırı (429 hataları)

• Neden: İstekleriniz, sağlayıcınızın belirlediği hız sınırlarını aşmış.

• Çözüm: Yeniden denemeden önce kısa bir süre bekleyin. Sürekli kullanım için sağlayıcı planınızı yükseltmeyi, farklı bir modele veya sağlayıcıya geçmeyi ya da istekleri farklı bir arka uca yönlendirmek üzere hermes chat --provider <alternative> kullanmayı değerlendirin.

Diğer Hermes Agent hataları ve çözümleri

API entegrasyonunun yanı sıra Hermes Agent; kurulum, yapılandırma veya çalışma sırasında başka hatalarla da karşılaşabilir. Bu sorunlar kurulum hatalarından agent davranışı problemlerine kadar uzanır. En yaygın olanlar ve çözümleri aşağıdadır.

Kurulumdan sonra hermes: command not found

• Neden: Kabuk, güncellenen PATH’i yeniden yüklememiş.

• Çözüm:

Hâlâ çalışmıyorsa kurulum konumunu doğrulayın:

Python sürümü çok eski

• Neden: Hermes, Python 3.11 veya daha yeni bir sürüm gerektirir.

• Çözüm:

Yükleyici bunu otomatik olarak halleder — bu hatayı manuel kurulum sırasında görürseniz önce Python’ı yükseltin.

Kurulum sırasında izin reddedildi hataları

• Neden: Kurulum dizinine yazmak için yeterli izin yok.

• Çözüm:

Mesajlaşma ağ geçidi üzerinden sudo çalışmıyor

• Neden: Mesajlaşma ağ geçidi etkileşimli bir terminal olmadan çalışır; bu yüzden sudo parola soramaz.

• Çözüm:

  • Mesajlaşmada sudo kullanmaktan kaçının — agent’tan alternatifler bulmasını isteyin

  • sudo kullanmanız gerekiyorsa /etc/sudoers içinde belirli komutlar için parolasız sudo yapılandırın

  • Ya da yönetim görevleri için terminal arayüzüne geçin: hermes chat

Docker arka ucu bağlanmıyor

• Neden: Docker daemon çalışmıyor veya kullanıcının yeterli izni yok.

• Çözüm:

Hermes API’ye hangi araçlar bağlanabilir?

Hermes API, OpenAI uyumlu biçimleri destekleyen pek çok modern AI istemcisi ve geliştirici aracıyla çalışmak üzere tasarlanmıştır. Böylece Hermes’i mevcut sohbet arayüzlerine ve uygulama çatilerine büyük değişiklikler yapmadan eklemek kolaylaşır. Hermes’e bağlanabilen bazı platformlar şunlardır:

• Open WebUI

Open WebUI, OpenAI ile çalışan bir endpoint üzerinden Hermes API’ye bağlanır ve tarayıcınızda sohbet etmenizi sağlar. Genellikle prompt’ları test etmek ve AI yanıtlarını gerçek zamanlı görmek için kullanılır. Bu da onu barındırılan veya yerel kurulumlar için pratik bir seçenek hâline getirir.

• LobeChat

LobeChat, birden çok modeli destekleyen modern bir sohbet arayüzü sunmak için Hermes API ile entegre olur. Sohbet geçmişi, oturum yönetimi ve model değiştirme gibi özellikler içerir. Bu nedenle hem gündelik kullanım hem de AI denemeleri için yararlıdır.

• LibreChat

LibreChat, Hermes API ile OpenAI tarzı bir arka uç olarak çalışır ve tam özellikli bir sohbet sistemi sunar. Birden çok sağlayıcıyı, gelişmiş ayarları ve konuşma yönetimini destekler. Çoğunlukla kendi kendine barındırılan ve özelleştirilebilir AI kurulumlarında kullanılır.

• NextChat

NextChat, hızlı ve hafif bir sohbet deneyimi sunmak için Hermes API’ye bağlanır. Minimum kurulum ve AI yanıtlarına hızlı erişimle sadeliğe odaklanır. Temiz arayüz, akıcı performans ve güvenilir günlük kullanım isteyen kullanıcılar için idealdir.

• ChatBox

ChatBox, masaüstü kullanım için özel endpoint yapılandırmasıyla Hermes API’yi destekler. Başlıca prompt test etmek ve konuşmaları yerel olarak yönetmek için kullanılır. Sade tasarımı sayesinde hem yeni başlayanlar hem de geliştiriciler için kullanımı kolaydır.

• AnythingLLM

AnythingLLM, belge tabanlı AI sistemleri ve bilgi asistanları oluşturmak için Hermes API’ye bağlanır. Kullanıcıların dosya yükleyip AI ile kendi verileri üzerinde sohbet etmesine olanak tanır. Bu da onu güçlü esneklik ve kontrol gerektiren özel, veri odaklı iş akışları için yararlı kılar.

• OpenAI SDK (Python / JavaScript)

OpenAI SDK, OpenAI uyumlu bir yapıyı izlediği için Hermes API ile çalışır. Geliştiriciler mevcut kodlarını yeniden kullanarak uygulamalar ve otomasyon sistemleri oluşturabilir. İstekler ve AI yanıtları üzerinde tam denetim sağlar ve sorunsuz entegrasyon desteği sunar.

Hermes API nasıl çalışır?

Hermes API, OpenAI uyumlu bir mimari üzerine kuruludur ve /v1/chat/completions ile /v1/responses endpoint’lerini destekler. Bu sayede mevcut istemci kodunda değişiklik gerektirmeden standart OpenAI SDK’larla doğrudan çalışır.

Bir istek geldiğinde Hermes tüm agent sistemini çalıştırır, terminal, dosya, web ve bellek gibi ilgili araçları yürütür ve yapılandırılmış bir yanıt döndürür. Ayrıca streaming’i destekler; böylece araç yürütme ilerlemesi gerçekleştiği anda görünür olur ve ön yüzde her adımda gözlemlenebilirlik sağlanır.

Hermes Agent ile gerçekte neler yapabilirsiniz?

Hermes, yalnızca prompt’lara yanıt vermek yerine düşünebilen, planlayabilen ve görevleri yürütebilen akıllı bir agent sistemi olarak tasarlanmıştır. Akıl yürütmeyi araç kullanımı ve bellekle birleştirerek gerçek eylemleri gerçekleştirebilir. Hermes’in pratik kullanımda yapabildikleri şunlardır:

• AI uygulamaları geliştirin

Hermes, basit sohbet araçlarından çok dijital asistanlar gibi çalışan akıllı uygulamalar geliştirmek için kullanılabilir. Kullanıcı niyetini anlar ve bunu uygulama içinde anlamlı eylemlere dönüştürür. Bu uygulamalar sohbet asistanları, üretkenlik araçları veya akıllı panolar olabilir; Hermes de genel işlevselliği artırmak için akıl yürütme ve adım adım karar alma yetenekleri katar.

• Otonom AI agent’ları çalıştırın

Hermes, sürekli kullanıcı yönlendirmesi gerektirmeden görevleri tamamlayan bağımsız bir agent olarak çalışabilir. Bir hedef verildiğinde onu daha küçük adımlara böler, süreci planlar ve her adımı sırayla yürütür. Bu da onu araştırma, planlama veya problem çözme gibi, tam hedefe ulaşana kadar çalışmayı sürdüren karmaşık görevler için uygun kılar.

• İş akışlarını ve görevleri otomatikleştirin

Hermes, yapılandırılmış iş akışlarını otomatik yürüterek tekrarlayan dijital görevleri üstlenebilir. Verileri düzenleme, bilgiyi işleme veya her adımda manuel çaba gerektirmeden çıktı üretme gibi işlemleri yönetebilir. Böylece kullanıcıların zaman kazanmasına, tekrar eden işleri azaltmasına ve farklı görev ve süreçlerde tutarlı sonuçlar elde etmesine yardımcı olur.

• AI’yi harici araçlara ve ön yüzlere bağlayın

Hermes görevleri yürütürken programlar, dosya ortamları ve kullanıcı arayüzleri dâhil olmak üzere başka sistemlerle iletişim kurabilir. Bağlı araçlar arasında veri gönderip alabilir ve çalışırken bu araçlardan yararlanabilir. Bu, kararlarının gerçek dünyadaki sistemlerde doğrudan somut sonuçlara dönüşebileceği anlamına gelir; bu nedenle entegre dijital ortamlarda yararlıdır.

• Bellek destekli, uzun süre çalışan AI süreçleri kullanın

Hermes, yapılandırılmış iş akışlarını otomatik yürüterek tekrarlayan dijital görevleri üstlenebilir. Verileri düzenleme, bilgiyi işleme veya her adımda manuel çaba gerektirmeden çıktı üretme gibi işlemleri yönetebilir. Böylece kullanıcıların zaman kazanmasına, tekrar eden işleri azaltmasına ve farklı görev ve süreçlerde tutarlı sonuçlar elde etmesine yardımcı olur.

Sonuç

Hermes API tanıdık, OpenAI uyumlu bir biçim kullanır; bu nedenle mevcut istemcilerin ve araçların çoğu ek yapılandırma gerektirmeden bağlanabilir. Kimi gibi güvenilir bir model sağlayıcıyla birlikte kullanıldığında Hermes, gerçek iş akışlarını yönetmek için ihtiyaç duyduğu arka uca sahip olur. Bundan sonra kurulum tamamdır ve kullanıma hazırdır.