Hermes Ollama modelleri görünmüyor: katalog ve sağlayıcı kontrolleri

Ollama modelleriniz Hermes seçicisinden kaybolduysa yapılandırmaya dokunmadan önce sürümü kontrol edin: tam olarak bu belirtiye yol açan, Ollama'nın kendi kataloğuyla ilgili önbellek hatası 17 Eylül 2026'da tamamlanmış olarak kapatıldı ve düzeltmesi v2026.9.21 (hermes-agent 0.21.4) etiketinde bulunuyor, v2026.9.14'te değil. Ancak bu kapatılmış rapor tüm hikâye değil. 21 Eylül 2026 itibarıyla bir seçicide Ollama modellerinin eksik olmasıyla ilgili iki rapor daha hâlâ açıktı; üçüncü bir açık issue, görünür model listesi daha önce özelleştirilmiş herhangi bir sağlayıcıda aynı belirtiye yol açan bir Hermes Desktop mekanizmasını açıklıyor ve aynı etikette yayımlanan kaynak kodunu incelediğimde bu davranışın hâlâ mevcut olduğunu gördüm. Dördüncü yaygın neden ise hata bile değil. Her biri farklı bir işaret bırakır ve bu sayfanın amacı da bu işaretleri açıklamaktır.

Önce iki ayrımı netleştirelim; çünkü arama sonuçlarında ikisi de çakışıyor. Hermes Agent, Nous Research'ün Python aracısıdır (MIT lisanslı, arşivlenmemiş; GitHub API'sine göre son push 21 Eylül 2026). Hermes 3 ve Hermes 4, aynı laboratuvarın açık ağırlıklı LLM ailesidir; tamamen farklı bir üründür ve ayrıca Hermes adında ilgisiz bir JavaScript motoru da vardır — sürüm numaralarının hiçbiri burada geçerli değildir. Ayrıca yerel Ollama, Ollama Cloud değildir: Hermes, Custom Endpoint akışı üzerinden 11434 portundaki ücretsiz yerel çalışma zamanına ulaşırken Ollama Cloud, kendi sağlayıcı slug'ı ve kendi önbellek dosyası olan ayrı bir ücretli üründür. Birindeki eksik model, diğeri hakkında hiçbir şey söylemez.

Üç katmanın aynı fikirde olması gerekir ve bunlardan yalnızca biri Ollama'dır

"Model seçicide yok" ifadesi üç katmanın sonuncusuyla ilgilidir; teşhis, ilk anlaşmazlık gösteren katmanı bulma meselesidir.

# 1. Does Ollama itself list the model? This is the native catalog
#    Hermes reads when the endpoint qualifies for the /api/tags branch.
curl -s http://127.0.0.1:11434/api/tags | jq '.models[].name'

# 2. Does the OpenAI-compatible surface list it too? This is what a
#    generic custom endpoint is probed on.
curl -s http://127.0.0.1:11434/v1/models | jq '.data[].id'

Birinci katmanda göz ardı edilmesi gereken bir nokta: ollama list embedding modellerini de içerir ve embedding modeli, bir kodlama aracısının seçebileceği sohbet modeli değildir. Kunavo da embedding, metinden sese veya sesten metne model sunmaz; dolayısıyla barındırılan bir rota burada bu açığı kapatmaz.

Önce sürümünüzü kontrol edin ve dikkatle okuyun

Issue #112898 — "yerel Ollama model listesi seçicide titriyor" — tamamlandı olarak kapatıldı; 16 Eylül 2026'da açıldı ve 17 Eylül 2026'da kapatıldı. Pull request #113129 düzeltmeyi d6d6565 commit'i olarak birleştirdi ve bir GitHub karşılaştırması bu commit'i v2026.9.21 etiketinin içinde, v2026.9.14 etiketinin dışında konumlandırıyor: v2026.9.21…d6d6565 karşılaştırması sıfır önde commit ile geride durumunu döndürüyor; yani commit bu etiketin atasıdır. v2026.9.14…d6d6565 ise sıfır geride commit ile önde durumunu döndürüyor; yani etiket commit'in atasıdır, tersi değil. Katkıcının kendi #112900 numaralı pull request'i hâlâ açık; bu, düzeltmenin main içinde bulunmadığının işareti değildir: içeriği, yazarlığı korunarak birleştirilen pull request'e cherry-pick edildi. Tüm durumlar 21 Eylül 2026'da GitHub API'sinden okundu.

Şimdi tuzak. Bu tek etiketin içinde iki farklı sürüm numarası bulunuyor: v2026.9.21 konumunda pyproject.toml, version = "0.21.4" değerini okurken apps/desktop/package.json, "version": "0.17.6" değerini okuyor. Bu nedenle "Hermes Desktop 0.17.6" başlıklı bir hata raporu güncel bir derlemeyi tarif ediyor, eski bir derlemeyi değil — böyle bir raporu güncelliğini yitirmiş diye reddetmek kendi kanıtlarınızı yanlış tarihlendirir. Sürüm kontrolünün sınırını da unutmayın: bu, bir etiketteki git içerilmesidir. Gerçekte yüklediğiniz pip sürümünün, Homebrew formülünün, konteyner imajının veya masaüstü otomatik güncelleme kanalının bu commit'i taşıyıp taşımadığı doğrulanmadı.

Beş neden ve bunları ayıran işaret

Bunlardan ikisi kendi cümlesini hak ediyor. Masaüstü dondurması, önbellek sorunu olarak yanlış okunma olasılığı en yüksek olandır: v2026.9.21 etiketinde apps/desktop/src/store/model-visibility.ts okunurken, bir sağlayıcıda kaydedilmiş herhangi bir anahtar bulunduğunda işleyici sağlayıcı varsayılanlarını birleştirmeyi tamamen atlıyor; dolayısıyla daha sonra keşfedilen modeller menüye hiç girmiyor. Issue #114369, discover_models: true kullanan özel bir sağlayıcıda tam olarak bunu yeniden üretti ve çözüldüğü için değil, duplicate olarak kapatıldı; yeniden üretimde bir vLLM uç noktası kullanıldığından mekanizmayı Ollama'ya özgü bir yeniden üretim değil, sağlayıcıdan bağımsız olarak değerlendirin. İki tanesi daha açık ve çözümsüz: #89874 (özel bir Ollama sağlayıcısı için sıfır model; needs-repro etiketi taşıyor, dolayısıyla doğrulanmamış bir rapor, yerleşik bir kusur değil) ve #71169 (Ollama API'sinde bulunan, masaüstü açılır listesinde bulunmayan modeller). Bunlardan herhangi birinin #112898 ile aynı kök nedeni paylaşıp paylaşmadığı belirlenmiş değil.

Masaüstü belirtisi beklenenden de daha keskindir. Bu etikette model-catalog-menu.tsx içinde, daraltılmış aile listesi boş olan bir sağlayıcı tamamen atlanır — şikâyetin genellikle "sağlayıcım kayboldu" şeklinde olmasının, "sağlayıcım boş bir liste gösteriyor" şeklinde olmamasının nedeni budur.

Normal bir seçici açılışının size güncel olmayan bir liste göstermesinin nedeni

Bu, tüm arıza sınıfının altında yatan mekanizmadır ve bir kez anlamaya değer. Normal bir seçici açılışında yalnızca geçerli özel uç nokta canlı olarak yoklanır; yapılandırılmış diğer tüm uç noktaları $HERMES_HOME/provider_models_cache.json konumundaki disk önbelleği yanıtlar. HERMES_HOME, varsayılan olarak ~/.hermes değerini alır ancak üzerine yazılabilir; bu nedenle yolu varsaymayın. v2026.9.21 etiketindeki hermes_cli içinde üç pencere yeniden yoklamayı yönetir:

Bunlar belgelenmiş ayarlardan ziyade dahili kaynak sabitleridir; bu üçü için kullanıcıya açık bir ayar bu kontrolde bulunmadı. Bu koddaki bilinçli bir istisnayı bilmekte fayda var: Ollama'nın kendi API'sinden gelen boş bir katalog yalnızca kısa TTL içinde yetkili kabul edilir ve hiçbir zaman güncelliğini yitirmiş olarak sunulmaz; böylece ilk açılışta hiç modeli olmayan bir Ollama, yeni çekilen modeli yedi günlük pencerenin tamamı boyunca gizlemez. Önbellek satırları, normalleştirilmiş URL ile kimlik bilgisi, API modu ve ek başlıkların parmak izine göre anahtarlanır; çünkü birden çok sağlayıcı satırının farklı anahtarlarla tek bir proxy URL'sini paylaşması geçerli bir yapılandırma olabilir. Pratik sonuç şudur: anahtar döndürmek, aktarımı değiştirmek veya extra_headers değerini düzenlemek o satırın önbellek girdisini geçersiz kılar ve bir sonraki yoklamasız açılış, bir şey yenileyene kadar listeyi boş gösterir.

Kontroller, sırayla

1. Ollama'da bulunduğunu doğrulayın. Yukarıdaki iki curl komutunu çalıştırın. /api/tags modeli listelemiyorsa aşağı akıştaki hiçbir şey listeleyemez.
2. Sürümü doğrulayın. v2026.9.21 etiketinden daha eski bir derlemedeyseniz ve belirti doğru ile boş arasında gidip gelen bir listeyse, zaten düzeltilmiş bir hatayla karşı karşıyasınız — hata ayıklamadan önce yükseltin.
3. Yenilemeyi zorlayın. hermes model üzerindeki --refresh bayrağı, kendi yardım metninde seçici disk önbelleğini sildiğini ve her sağlayıcının canlı listesini yeniden aldığını belirtir; bunun tek bir sağlayıcıyı değil, her sağlayıcıyı temizlediğini unutmayın. Oturum içinde eğik çizgi komutları referansı, /model --refresh komutunun sağlayıcının model listesini yeniden aldığını belgeler; masaüstünde de normal açılışlar saatlik önbelleği kullanmaya devam ederken yeni bir katalog isteyen açık bir "Refresh Models" denetimi bulunur.
4. Uç noktanızın hangi yoklama yolunu kullandığını kontrol edin. Sağlayıcı ollama olarak adlandırıldığında, ad custom:ollama olduğunda veya -ollama ile bittiğinde, URL yapılandırılmış Ollama temel URL'siyle eşleştiğinde ya da belirsiz bir özel URL 11434 portunda gerçekten /api/tags isteğine yanıt verdiğinde Ollama'ya özgü /api/tags dalı kullanılır. Başka bir portta, düz custom adı altında sunulan bir Ollama bunun yerine genel /v1/models yoklamasına düşer — kod yolu incelendiğinde bu şekilde çalıştığı anlaşılıyor; yedek yolun pratikte çalıştığını doğrulamak için burada çalıştırılmadı.
5. Keşfin kendisi sorunsa keşfetmeyi bırakın. discover_models, varsayılan olarak true değerini alır; bunu false olarak ayarlamak, seçicinin canlı yoklama yerine yapılandırdığınız listeyi göstermesini sağlar.
6. Yalnızca masaüstü menüsü yanlışsa, büyük olasılıkla #107391 kapsamındasınız; hiçbir yenileme bunu temizlemez — arka uç modeli döndürür, işleyicinin düzenleme katmanı ise onu düşürür.

providers:
  # The published reference documents `api` for a providers entry.
  local-ollama:
    api: http://127.0.0.1:11434/v1
    # No key for local Ollama. Discovery is on by default; turn it off and
    # hand-write the list when the probe is the thing that is failing.
    discover_models: false
    models:
      - qwen3-coder:30b

model:
  default: qwen3-coder:30b
  provider: custom:local-ollama

Bir yapılandırma ayrıntısı kullanıcıların tekrar tekrar takılmasına neden oluyor; bunu netleştirmekte fayda var. Referans belgeleri, bir providers: girdisi için api değerini temel URL anahtarı olarak gösteriyor ve bu girdinin alan listesinde base_url ile url bunun kabul edilen diğer adları olarak belirtiliyor; base_url ise üst düzey model: eşlemesinin altındaki ayrı anahtardır. Ayrıca eski yapılandırmaların üst düzey bir custom_providers: listesinde api yerine base_url kullandığını, bunun hâlâ çalıştığını ve yapılandırma v12'de hermes update sırasında otomatik olarak geçirildiğini kaydediyor. Hata raporlarında her iki kullanım da yer alıyor; ikisinin de okunması durumunda bu beklenen bir şey. Dolayısıyla etkili olmayan bir providers: girdisinin bu anahtarın adından kaynaklanması pek olası değildir — uç noktayı ve girdinin diğer alanlarını inceleyin.

Adlandırmaya değer ayrı bir ayrıntı daha var: Ollama'nın kendi Hermes sayfası, kurulum istemini "Context length in tokens [leave blank for auto-detect]" şeklinde gösterirken, Hermes sağlayıcı belgeleri aracı kullanımı için en az 64.000 tokens gerektiriyor ve daha azını sunan yerel bir uç noktanın başlangıçta reddedildiğini belirtiyor. Her ikisi de 21 Eylül 2026'da kontrol edildi. Alanı boş bırakmak tek başına yanlış değildir, ancak yalnızca küçük bir pencere sunan bir sunucu için hiçbir şeyi değiştirmez — bu nedenle sunucudaki pencereyi artırın (veya Hermes yapılandırmasında sabitleyin) ve Hermes'in belirttiği değere getirin; bu hatanın, eksik bir seçici satırını değil, sunulan pencereyi belirten bir başlangıç reddi oluşturduğunu unutmayın.

Doğrulayın, ardından yerel kullanımın buna değip değmeyeceğine karar verin

Bir değişiklikten sonra şu üç işlemi sırayla yapın: --refresh kullanmadan seçiciyi yeniden açın ve modelin soğuk açılışta listelendiğini doğrulayın, modeli seçin ve bir tamamlama döndüren, sınırları belirlenmiş tek bir istek gönderin. Ortadaki adım önemlidir; çünkü yalnızca bir yoklamadan hemen sonra doğru olan bir liste, düzeltmeden çok önbellek hatasının imzasıdır. Bunlar sizin çalıştırmanız gereken talimatlardır — bu sayfa yazılırken Hermes kurulumu, Ollama örneği veya seçici çalıştırılmadı.

Yerel kullanımın bu görev için uğraşa değmeyeceği sonucuna varırsanız, maliyet sorusu net biçimde ikiye ayrılır: yazılımın maliyeti ve model kullanımının maliyeti.

Ollama Cloud'un Pro katmanı da yıllık faturalandırmayla yıllık $200 olarak listeleniyor ve planları aylık kullanım kredileri içeriyor — Pro'da $60, Max'te $300, Team'de ortak $1.000. Bunlar yerel uç nokta için değil, bulut ürünü içindir.

Ölçümlenen rota için aşağıda ölçülmüş bir görev maliyeti veya fatura tavanı olmayan, açıklayıcı token aritmetiği yer alıyor. Önbelleğe alınmamış 200.000 giriş tokenı gönderen ve 12.000 çıkış tokenı alan, önbellek okuması ve harici araç ücreti olmayan tek bir oturum varsayın. Ücretler, milyon token başına güncel Kunavo kataloğu fiyatlarıdır.

Bunu bütçe olarak değerlendirmeden önce kendi günlük oturum sayınızla ölçeklendirin ve listelenen en düşük ücret ile görevi tamamlamanın en düşük maliyetinin farklı iddialar olduğunu unutmayın — üç deneme gerektiren ucuz bir model, tek denemede işi bitiren bir modelden daha pahalı olabilir. Kunavo kataloğundaki tutar bir faturalandırma tabanıdır, tavan değildir: üst kaynak ücretini bildirdiğinde fatura, katalog maliyeti ile üst kaynak maliyetinin geçerli çarpanla çarpımından büyük olanıdır. Faturalandırma ayrıntılarına bakın.

Hangi rotanın kazandığı işe bağlıdır. Yerel Ollama, istek başına ücret olmadan küçük, özel veya çevrimdışı görevlerde öne çıkar; gerçek kısıtlar donanım ve 64.000 tokenlık minimumdur. Tek bir sağlayıcının amiral modelini kullanıyor ve sağlayıcının kendi önbellekleme ve toplu işlem koşullarını istiyorsanız doğrudan sağlayıcı API'si öne çıkar. Görev başına model değiştiriyor ve tek anahtar ile tek bakiye istiyorsanız geçit öne çıkar. Sabit ücretli yoğun günlük kullanım, ölçümlenen tokenlardan size daha uygunsa abonelik öne çıkar.

Hermes'i başka bir yere yönlendirme

Yerel uç noktanın yanına barındırılan bir uç nokta eklemeye karar verirseniz, işleyiş aynı özel sağlayıcı akışını izler. Denemeden önce bilmeniz gereken bir kısıtlama vardır: sağlayıcı ekleme işlemi, bir oturumun dışında çalıştırılan hermes model ile yapılır; çünkü oturum içindeki /model yalnızca önceden yapılandırılmış sağlayıcılar arasında geçiş yapar ve sağlayıcı ekleyemez veya anahtar kabul edemez. Hermes Agent özel API, giriş biçimini, aktarım yöntemlerini ve geri alma işlemini ayrıntılı olarak ele alır; Hermes Agent fiyatlandırması ise dört ayrı faturayı açıklar. Kunavo, uyumluluk testleri yerine yapılandırma referansları yayımlar: bu çalışma kapsamında Hermes, Kunavo'nun uç noktasına karşı çalışma zamanında hiç test edilmemiştir; dolayısıyla buradaki hiçbir bilgi, Hermes'in keşif işleminin bu uç noktada başarılı olduğunu ortaya koymaz. Denerken çalışan bağlantı yolunuzu koruyun. Ollama'nın OpenAI uyumlu API'si, aynı istemci kodunun her ikisine de neden erişebildiğini açıklar; bir anahtar için bakiye yüklemek istediğinizde Kunavo hesabı oluşturun.

Bir istemcide hata ayıklamak yerine hâlâ istemci mi seçiyorsunuz? Hermes Agent alternatifleri ve OpenAI uyumlu API daha geniş alanı kapsar.

Sık sorulan sorular

21 Eylül 2026'da neyin ve nasıl kontrol edildiği: sorun ve çekme isteği durumları, her iki düzeltme için etiket kapsamı, en son sürüm etiketi ve deponun lisans ve arşiv durumu GitHub API'sinden alındı; önbellek sabitleri, keşif koşulları, masaüstü görünürlük deposu, --refresh yardım metni ve belgelerdeki alıntılar v2026.9.21 etiketindeki kaynak koddan okundu; Ollama'nın fiyatlandırma sayfası, Ollama'nın kendi Hermes entegrasyon sayfası ve Nous Portal plan listesi aynı gün alındı. Kontrol edilmeyenler: yüklediğiniz pip, Homebrew, container veya masaüstü otomatik güncelleme yapısının bu düzeltmelerden herhangi birini içerip içermediği. Burada hiçbir şey çalışma zamanında test edilmedi — Hermes kurulumu çalıştırılmadı, Ollama başlatılmadı ve hiçbir seçici açılmadı. Kunavo token ücretleri canlı katalogdan gelir ve dolar örneği, ölçülmüş bir görev maliyeti değil, açıklayıcı token aritmetiğidir.