Hermes Agent LLMTR eklentisi: profil dosyası ve kurulum

Eklenti sözleşmesi: çekirdek ağaç değil, eklenti dizini

Hermes Agent’ın katkı politikası üçüncü taraf sağlayıcı entegrasyonlarını çekirdek ağacın dışında tutar. Bir sağlayıcı eklemek için depoyu çatallamak ya da çekirdek dosyalara dokunmak gerekmez; sağlayıcı yükleyicisi eklenti dizinini çalışma anında tarar ve bulduğu profili kaydeder.

Bu yüzden LLMTR entegrasyonu iki yerde birden yaşıyor. knowhycodata/hermes-agent deposundaki feat/add-llmtr-provider dalı profili çekirdek ağacın eklenti klasörü altında, testleriyle birlikte tutar; knowhycodata/hermes-llmtr-plugin deposu ise aynı profili kendi başına kurulabilen bağımsız bir paket olarak yayınlar. İkisi de aynı bildirimi taşır, farkları yalnızca nereye kopyalandıklarıdır.

Eklentinin kendisi iki dosyadan ibaret: bir eklenti bildirimi ve bir sağlayıcı profili. Bildirim adı, türü ve sürümü söyler; profil ise sağlayıcının kimliğini kurar.

Kurulum: dizin adı sağlayıcı adıdır

Bağımsız paket, deponun eklenti dizini altına klonlanarak kurulur. Burada dikkat edilecek tek şey hedef dizinin adıdır: dizin adı sağlayıcı adı olur. Klasörü başka bir adla açarsanız sağlayıcı o adla kaydolur ve yapılandırmanızdaki sağlayıcı alanı artık eşleşmez.

Linux, macOS ve WSL tarafında hedef ev dizinindeki eklenti klasörüdür. Yerel Windows kurulumunda hedef, kullanıcının yerel uygulama verisi altındaki karşılığıdır. Aşağıdaki döküm iki yolu da veriyor.

Bağımsız eklentiyi Hermes eklenti dizinine llmtr adıyla klonlama

# Linux / macOS / WSL
git clone https://github.com/knowhycodata/hermes-llmtr-plugin \
  ~/.hermes/plugins/model-providers/llmtr

# Yerel Windows (PowerShell)
# git clone https://github.com/knowhycodata/hermes-llmtr-plugin `
#   "$env:LOCALAPPDATA\hermes\plugins\model-providers\llmtr"

# Dizin adi MUTLAKA llmtr olmali: saglayici adi buradan gelir.

Profil dosyası neyi bildiriyor

Profil, özel taşıma kancası içermeyen düz bir sağlayıcı profilidir. Kimlik doğrulama standart bir taşıyıcı başlığı, model kimlikleri sağlayıcı ön ekli slug, katalog uç noktası genel model listelemesi olduğu için temel profil isteği, akışı, araç çağrılarını ve canlı model listesini kendisi yürütür. Eklentide yazılan tek şey kimlik bildirimidir.

Bildirilen alanlar arasında dikkat çeken iki tanesi var. Birincisi takma adlar: sağlayıcı llmtr adının yanı sıra üç yazım biçimiyle de çözümlenir, böylece yapılandırmasında noktalı ya da tireli yazan kullanıcı hata almaz. İkincisi ortam değişkenleri: anahtar için biri, base URL geçersiz kılma için diğeri olmak üzere iki ad tanınır.

Eklentinin sağlayıcı profili: kimlik, uç ve model bildirimi

llmtr = ProviderProfile(
    name="llmtr",
    aliases=("llm-tr", "llmtr-com", "llmtr.com"),
    env_vars=("LLMTR_API_KEY", "LLMTR_BASE_URL"),
    display_name="LLMTR",
    base_url="https://llmtr.com/v1",
    fallback_models=(
        "anthropic/claude-opus-4.8",
        "anthropic/claude-sonnet-4.6",
        "openai/gpt-5.5",
        "google/gemini-3.1-pro-preview",
        "deepseek/deepseek-v4-pro",
        "qwen/qwen3.7-max",
        "zai/glm-5.1",
    ),
    default_aux_model="google/gemini-2.5-flash",
)

register_provider(llmtr)

Alan alan: hangi bildirim neye karar veriyor

Profildeki her alanın çalışma anında somut bir karşılığı var. Aşağıdaki tablo alanları, dalın testlerinde sabitlenen davranışlarla birlikte veriyor; testler kimlik sözleşmesini bilerek çiviliyor, çünkü geri kalan her şey bu sözleşmeden otomatik türetiliyor.

Bildirim dosyası ise yalnızca paket kimliğini taşır: eklenti adı llmtr-provider, türü model sağlayıcı, sürümü 1.0.0. Yükleyici bu dosyayı gördüğünde dizini bir eklenti olarak kabul eder.

Yedek liste, yardımcı model ve uç seçimi

Yedek liste yalnızca canlı model listelemesi okunamadığında devreye girer; normal koşulda seçici uçtan gelen listeyi gösterir. Listeye giren yedi kimliğin ortak özelliği araç çağırabilmeleri, yani bir ajan döngüsünü sürdürebilmeleri. Testler bu listedeki her öğenin sağlayıcı ön ekli slug biçiminde olmasını da ayrıca doğruluyor.

Yardımcı model ayrı bir alandır ve boş bırakılmadığı için Hermes yardımcı sağlayıcı uyarısını göstermez. Sıkıştırma, görsel işleme ve özet gibi arka plan işleri bu modele gider; ana modeli değiştirseniz de yardımcı iş aynı yerde kalır.

Bir ayrıntı yapılandırırken işinize yarar: profil sohbet tamamlama taşımasını kullanır, ama listedeki her kimlik ağ geçidinde aynı uca bağlı değildir. Ağ geçidinde köprü yönü asimetriktir. Sohbet tamamlama isteği, modelin sohbet ya da responses bağlantısı varsa çalışır; responses isteği ise yalnızca responses bağlantısı olan modellerde çalışır. Bu yüzden yedek listedeki openai/gpt-5.5 kimliği, responses tarafında yayımlanmış olmasına rağmen Hermes’in sohbet taşımasından sürülebilir.

• Seçicide model görünmüyorsa önce anahtarın okunup okunmadığına bakın; liste uçtan geliyor
• Yedek liste görünüyorsa canlı listeleme başarısız olmuş demektir
• Yardımcı model alanını değiştirmek istiyorsanız profil dosyasındaki tek satırı düzenleyin
• Yapılandırmada sağlayıcı adını takma adlarla da yazabilirsiniz; hepsi aynı profile çözümlenir

Yapılandırma ve doğrulama

Kurulumdan sonra tek zorunlu adım anahtarı ortama koymaktır. Base URL geçersiz kılma isteğe bağlıdır ve boş bırakıldığında profildeki değer kullanılır. Modeli her oturumda seçmek yerine yapılandırma dosyasına da yazabilirsiniz.

Doğrulama için iki komut var: model seçici sağlayıcıyı ve kimlikleri listeler, tanılama komutu ise kimlik doğrulamayı ve erişilebilirliği kontrol eder. Aşağıdaki tablo, bağımsız eklenti deposunda kayıtlı uçtan uca doğrulamayı özetliyor; sayı o denemenin tarihine ait bir okumadır, güncel katalog listelemesi her zaman uçtan okunur.

Anahtarı ayarlama, modeli seçme ve tanılama komutunu çalıştırma

export LLMTR_API_KEY=llmtr-your_key
# istege bagli, varsayilan profildeki degerdir
# export LLMTR_BASE_URL=https://llmtr.com/v1

hermes model     # LLMTR'yi secin, ardindan bir saglayici/model slug'i secin
hermes doctor    # kimlik dogrulama ve erisilebilirlik kontrolu

# ya da dogrudan yapilandirmaya yazin:
# provider: llmtr
# model: anthropic/claude-opus-4.8

Sık sorulan sorular

Eklentiyi kurarken dizin adını değiştirebilir miyim?

Değiştirmemelisiniz. Hermes sağlayıcı adını dizin adından alır. Klasörü llmtr dışında bir adla açarsanız sağlayıcı o adla kaydolur ve yapılandırmanızdaki sağlayıcı alanı ile takma adlar artık eşleşmez.

Çekirdek daldaki profil ile bağımsız eklenti deposu arasındaki fark nedir?

Taşıdıkları bildirim aynıdır. Fark kurulum yeridir: dal profili çekirdek ağacın eklenti klasöründe testleriyle tutar, bağımsız depo ise Hermes’in katkı politikasına uygun olarak kullanıcının eklenti dizinine klonlanır. Çatallamaya ve çekirdek düzenlemesine gerek kalmaz.

Yedek model listesi seçicide neden görünüyor?

Yedek liste yalnızca canlı model listelemesi okunamadığında gösterilir. Görüyorsanız uçtan liste alınamamıştır: anahtarın ortamda okunduğunu ve base URL geçersiz kılmasının doğru olduğunu kontrol edin.

Yardımcı model neden ayrıca bildiriliyor?

Sıkıştırma, görsel işleme ve özet gibi arka plan işleri ana modelden ayrı yürütülür. Profil bu iş için bir model bildirmezse Hermes yardımcı sağlayıcı yapılandırılmadı uyarısını gösterir; bildirim bu uyarıyı önler ve yardımcı işlerin nereye gideceğini belirler.

İlgili yazılar

• LLMTR entegre geliştirici araçları: 21 aracın bağlanma biçimi
• DeepSeek Harness LLMTR eklentisi: LLM dikişi ve katalog
• HarnessRouter LLMTR sağlayıcısı: tek anahtarla üç harness

• Model katalogu
• Chat Completions rehberi
• API anahtarlari
• Fiyatlandirma