Skip to main content
CometAPI’yi Hermes Agent için model sağlayıcısı olarak kullanın. Hermes, bu kılavuzda iki CometAPI yolunu destekler: çoğu metin modeli için genel bir OpenAI uyumlu endpoint ve Anthropic Messages üzerinden bir Claude rotası.

Ön koşullar

  • Git
  • Etkin bir API anahtarına sahip bir CometAPI hesabı
  • macOS, Linux veya WSL2 üzerinde bir terminal

Kurulum

1

CometAPI API anahtarınızı alın

CometAPI konsolu’na giriş yapın. Add API Key seçeneğine tıklayın ve CometAPI API anahtarınızı kopyalayın.
Add API Key düğmesini gösteren CometAPI kontrol paneli
Base URL'nin gösterildiği CometAPI API anahtarı ayrıntıları
2

Hermes Agent'ı yükleyin

Aşağıdaki komut resmi yükleyiciyi çalıştırır:
Geçerli kabuk henüz hermes komutunu görmüyorsa, kabuk yapılandırmasını yeniden yükleyin:
Hermes, yapılandırmayı ~/.hermes/ içinde saklar, hermes komutunu ~/.local/bin içine bağlar ve ~/.local/bin yolunu kabuk PATH’inize ekleyebilir.

Yapılandırma

Model ailesiyle eşleşen CometAPI rotasını seçin:
Hermes’i yerel Gemini sağlayıcısı olarak https://api.cometapi.com/v1beta ile yapılandırmayın. Gemini modelleri için OpenAI uyumlu Hermes yapılandırmasını kullanın. Doğrudan Gemini API çağrıları için Gemini generateContent API kullanın.
1

CometAPI anahtarınızı saklayın

~/.hermes/.env dosyasını açın ve aşağıdaki değerleri ekleyin:
COMETAPI_KEY, adlandırılmış Claude provider tarafından kullanılır. OPENAI_API_KEY, Hermes’in özel OpenAI uyumlu endpoint geri dönüşünün çalışmaya devam etmesini sağlar.
2

OpenAI uyumlu rotayı yapılandırın

Bu rotayı, Hermes’ten kullanılan Gemini modelleri dahil olmak üzere çoğu CometAPI metin modeli için kullanın. ~/.hermes/config.yaml dosyasını açın ve model bölümünün şu şekilde göründüğünden emin olun:
your-model-id değerini CometAPI Models sayfasındaki güncel bir metin model ID ile değiştirin.
API anahtarını ~/.hermes/.env içinde tutun. Gizli bilgileri config.yaml içine doğrudan yazmayın.
Bu kurulum ana sohbet modelini yapılandırır. Hermes, vision veya web extraction gibi görevler için ayrı yardımcı modeller kullanabilir.
3

Claude Messages rotasını yapılandırın

Hermes’in Claude modellerini Anthropic Messages üzerinden çağırmasını istediğinizde bu rotayı kullanın. ~/.hermes/config.yaml dosyasını açın ve adlandırılmış bir provider kullanın:
your-claude-model-id değerini CometAPI Models sayfasındaki güncel bir Claude model ID ile değiştirin.
Bu rota için base_url değerini https://api.cometapi.com olarak bırakın. Hermes, adlandırılmış provider üzerinden Anthropic Messages transport kullanır.

Doğrulama

1

Yapılandırmayı kontrol edin

Aşağıdaki komut, Hermes’in yapılandırmayı ve API anahtarını okuyabildiğini doğrular:
Eğer hermes config check bir güncellemeden sonra eksik seçenekler bildirirse, hermes config migrate komutunu çalıştırın ve tekrar kontrol edin.
2

Gerçek bir sohbet testi çalıştırın

Aşağıdaki komut, CometAPI üzerinden gerçek bir istek gönderir:
Başarılı bir kurulum CONNECTED döndürür ve auth veya endpoint hataları vermez. Claude Messages yapılandırması etkin olduğunda bu, Hermes’in CometAPI üzerinden anthropic_messages transport kullanabildiğini doğrular.

İsteğe bağlı yapılandırma

Daha eski bir Hermes kurulumunu değiştiriyorsanız, önce yerleşik kaldırıcıyı kullanın:
Kaldırıcıda, CLI, PATH girdisi ve ~/.hermes/ verilerini kaldırmak için Full uninstall seçeneğini tercih edin. Ardından kurulum adımını yeniden çalıştırın ve aynı CometAPI yapılandırmasıyla devam edin.
OpenAI-compatible route için etkileşimli akışı tercih ediyorsanız, hermes model komutunu çalıştırın ve Custom endpoint seçeneğini seçin.Ardından aşağıdaki değerleri girin:
  • Base URL: https://api.cometapi.com/v1
  • API key: CometAPI API anahtarınız
  • Model: geçerli bir CometAPI metin model ID
Bu akış, OpenAI-compatible provider ayarlarını config.yaml içine yazar. Claude Messages için, adlandırılmış provider transport: anthropic_messages değerini koruyacak şekilde config.yaml dosyasını doğrudan düzenleyin.