Hermes Agent Model ve Sağlayıcı Ayarları: OpenRouter, OpenAI, Anthropic Rehberi

Hermes Agent’ın en güçlü yanlarından biri, tek bir arayüz üzerinden onlarca farklı yapay zeka modeli ve sağlayıcısıyla çalışabilmesi. Kurulumdan sonraki ilk adım, ihtiyacınıza en uygun modeli seçmek ve doğru sağlayıcıyı yapılandırmak. Bu yazıda Hermes Agent’da model ve sağlayıcı ayarlarını nasıl yapacağınızı, OpenRouter, OpenAI, Anthropic, DeepSeek ve local modelleri nasıl kullanacağınızı adım adım anlatıyorum.

Hermes Agent Model Ayarları Neden Önemli?

Hermes Agent, varsayılan olarak belirli bir modelle gelmez. Kurduğunuzda sizi bir model seçme ekranı karşılar. Bu esneklik sayesinde her görev için en uygun modeli kullanabilirsiniz. Örneğin günlük kod yazma işlerinde hızlı bir model, karmaşık analizlerde daha güçlü bir model tercih edebilirsiniz. Hermes Agent model ayarları, ajanın hangi yapay zeka modeliyle düşüneceğini, hangi API sağlayıcısı üzerinden çalışacağını ve gerektiğinde nasıl yedek sağlayıcılara geçeceğini belirler.

Bu ayarları doğru yapmak, hem performans hem de maliyet açısından büyük fark yaratır. Haydi adım adım inceleyelim.

1. Hermes Agent Model Seçme Aracı: hermes model

Model seçmenin en kolay yolu, interaktif model seçme aracını kullanmak. Terminalde şu komutu yazmanız yeterli:

hermes model

Bu komut sizi bir menüde karşılar. Buradan:

• Sağlayıcı (provider) seçebilirsiniz: OpenRouter, Anthropic, OpenAI, DeepSeek, Google Gemini, xAI/Grok ve daha fazlası
• Model seçebilirsiniz: seçtiğiniz sağlayıcının sunduğu tüm modeller listelenir
• API anahtarınızı girebilir veya mevcut anahtarı kullanabilirsiniz

Seçiminizi yaptıktan sonra Hermes Agent, ayarları ~/.hermes/config.yaml dosyasına kaydeder ve yeni oturumda seçtiğiniz modeli kullanmaya başlar.

2. OpenRouter Kullanımı: En Esnek Seçenek

OpenRouter, Hermes Agent ile birlikte kullanılan en yaygın sağlayıcıdır. OpenRouter, tek bir API anahtarıyla onlarca farklı modele erişmenizi sağlar. Claude, GPT-4, Gemini, DeepSeek ve daha birçok modele aynı hesap üzerinden ulaşabilirsiniz.

OpenRouter kullanmak için:

1. OpenRouter.ai adresine gidip ücretsiz hesap oluşturun
2. Dashboard’dan API anahtarı alın
3. Hermes Agent’da hermes model ile OpenRouter’ı seçin
4. İstenen API anahtarını girin

Alternatif olarak API anahtarını doğrudan OPENROUTER_API_KEY değişkeni olarak ~/.hermes/.env dosyasına ekleyebilirsiniz:

OPENROUTER_API_KEY=sk-or-v1-buraya-kendi-anahtarinizi-yazin

OpenRouter’ın avantajı, kredi bitince veya bir model hata verdiğinde otomatik olarak yedek modele geçebilmesidir. Hermes Agent’ın credential pooling özelliği ile birden fazla OpenRouter API anahtarınız varsa, bunları sırayla kullanarak kesintisiz çalışabilirsiniz.

3. OpenAI ve Anthropic Modelleri

OpenAI (GPT-4, GPT-4o) ve Anthropic (Claude 3.5 Sonnet, Claude 4) modellerini doğrudan kullanmak isterseniz, ilgili sağlayıcıdan API anahtarı almanız yeterli.

OpenAI Yapılandırması

hermes model

Menüden OpenAI sağlayıcısını seçin ve OPENAI_API_KEY anahtarınızı girin. Alternatif olarak .env dosyasına manuel ekleyebilirsiniz:

OPENAI_API_KEY=sk-proj-buraya-kendi-anahtarinizi-yazin

Anthropic Claude Yapılandırması

Anthropic Claude modelleri, özellikle uzun yazılım geliştirme oturumlarında büyük bağlam (context) penceresi sayesinde tercih edilir. hermes model ile Anthropic sağlayıcısını seçin:

ANTHROPIC_API_KEY=sk-ant-buraya-kendi-anahtarinizi-yazin

Claude Sonnet 4 veya Claude Opus gibi modeller arasından seçim yapabilirsiniz. Anthropic’in en büyük avantajı, kod yazma ve hata ayıklama konusundaki başarısıdır.

4. DeepSeek ve Google Gemini Kullanımı

Hermes Agent, DeepSeek ve Google Gemini gibi popüler modelleri de destekler. Özellikle DeepSeek, uygun fiyat-performans oranıyla dikkat çeker.

DeepSeek

DEEPSEEK_API_KEY=sk-buraya-kendi-anahtarinizi-yazin

Google Gemini

GOOGLE_API_KEY=AIza-buraya-kendi-anahtarinizi-yazin

Bu API anahtarlarını ~/.hermes/.env dosyasına ekledikten sonra hermes model menüsünden istediğiniz sağlayıcıyı seçerek kullanmaya başlayabilirsiniz.

5. Local (Yerel) Modellerle Çalışma

Hermes Agent model değiştirme denildiğinde akla gelen bir diğer seçenek de local modeller. İnternet bağlantısı olmadan, tamamen kendi bilgisayarınızda çalışan modeller kullanmak isterseniz, Hermes Agent buna da izin verir.

Local model kullanmak için önce bir model sunucusu çalıştırmanız gerekir. En yaygın yöntem Ollama veya LocalAI kullanmaktır.

Ollama ile Local Model

1. Ollama’yı kurun: curl -fsSL https://ollama.com/install.sh | sh
2. Bir model indirin: ollama pull llama3 veya ollama pull mistral
3. Hermes Agent’da hermes model ile Custom Endpoint seçin
4. Base URL olarak http://localhost:11434/v1 girin (Ollama OpenAI-uyumlu API sunar)
5. Model adı olarak llama3 veya indirdiğiniz modelin adını yazın

Local modeller, hassas verilerle çalışırken veya API ücretlerinden kaçınmak istediğinizde idealdir. Ancak büyük modeller için güçlü bir GPU ve yeterli RAM gerekebilir.

6. Yapılandırmayı Elle Düzenleme

İnteraktif menü yerine yapılandırmayı doğrudan düzenlemek isterseniz:

hermes config edit

Bu komut ~/.hermes/config.yaml dosyasını varsayılan metin düzenleyicinizde açar. Model ayarları şu şekilde görünür:

model:
  default: anthropic/claude-sonnet-4
  provider: openrouter
  base_url: https://openrouter.ai/api/v1

Belirli bir anahtarı komut satırından da değiştirebilirsiniz:

hermes config set model.default deepseek/deepseek-v4-pro
hermes config set model.provider openrouter

Mevcut yapılandırmayı görmek için:

hermes config

7. Model Locking: Tek Modele Sabitleme

Bazı durumlarda Hermes Agent’ın belirli bir modelin dışına çıkmasını istemeyebilirsiniz. Örneğin, bir proje boyunca yalnızca Claude kullanmak isteyebilirsiniz. Bunun için model locking (kilit) yapabilirsiniz:

1. hermes config set model.default anthropic/claude-sonnet-4 ile varsayılan modeli belirleyin
2. Diğer sağlayıcıların API anahtarlarını .env dosyasından yorum satırına alın veya silin
3. Hermes Agent artık yalnızca belirlediğiniz modeli kullanır

Bu yaklaşım özellikle ekip ortamlarında veya üretim otomasyonlarında tercih edilir.

8. Yardımcı Araç Kontrolleri

Model ve sağlayıcı ayarlarını yaptıktan sonra her şeyin doğru çalıştığını kontrol etmek için:

hermes doctor     # Bağımlılıkları ve yapılandırmayı kontrol eder
hermes status     # Bileşen durumlarını gösterir

Eğer “Model not found” veya “Provider authentication failed” gibi hatalar alıyorsanız, API anahtarınızın geçerli olduğundan ve doğru sağlayıcıyı seçtiğinizden emin olun.

Sık Sorulan Sorular

Hermes Agent model değiştirme nasıl yapılır?

hermes model komutunu çalıştırın, açılan menüden yeni sağlayıcı ve model seçin. Değişiklik bir sonraki oturumda geçerli olur.

OpenRouter ücretsiz mi?

OpenRouter’ın kendisi ücretsizdir ancak kullandığınız modellerin API ücretlerini ödersiniz. Bazı küçük modeller için ücretsiz kotalar mevcuttur.

Local model kullanmak için GPU şart mı?

Küçük modeller (3B-8B parametre) CPU’da çalışabilir. Daha büyük modeller için GPU önerilir.

Özet

Hermes Agent model ayarları, ajanın verimliliğini doğrudan etkiler. OpenRouter esnek bir başlangıç noktası sunarken, doğrudan OpenAI veya Anthropic kullanmak daha tutarlı bir deneyim sağlayabilir. DeepSeek uygun maliyetli bir alternatif, local modeller ise tam gizlilik ve bağımsızlık sunar.

Hangi modeli seçerseniz seçin, Hermes Agent’ın mimarisi aynı kalır. Tek yapmanız gereken doğru API anahtarını yapılandırmak ve hermes model ile seçiminizi yapmak. Önceki yazıda Hermes Agent kurulumunu anlatmıştım; bu yazıyla birlikte artık hem kurabilir hem de istediğiniz modelle çalıştırabilirsiniz.

Hangi model sağlayıcısını kullanıyorsunuz? Deneyimlerinizi yorumlarda paylaşın.