Model Hermes Ollama tidak muncul: pemeriksaan katalog dan penyedia

Jika model Ollama Anda menghilang dari picker Hermes, periksa versinya sebelum menyentuh konfigurasi: bug cache katalog native yang menghasilkan gejala persis ini ditutup sebagai selesai pada 17 September 2026, dan perbaikannya terdapat dalam tag v2026.9.21 (hermes-agent 0.21.4), tetapi tidak dalam v2026.9.14. Namun, laporan yang ditutup itu bukan keseluruhan ceritanya. Dua laporan lain tentang model Ollama yang hilang dari picker masih terbuka pada 21 September 2026; issue terbuka ketiga menjelaskan mekanisme Hermes Desktop yang menghasilkan gejala sama pada provider apa pun yang daftar model terlihatnya pernah dikustomisasi, dan saya membaca bahwa perilaku tersebut masih ada dalam source yang dikirimkan pada tag yang sama. Penyebab umum keempat sama sekali bukan cacat. Masing-masing meninggalkan petunjuk yang berbeda, dan petunjuk itulah tujuan halaman ini.

Dua pembedaan terlebih dahulu, karena keduanya bertabrakan dalam hasil pencarian. Hermes Agent adalah agent Python dari Nous Research (MIT, tidak diarsipkan, terakhir didorong pada 21 September 2026 menurut GitHub API). Hermes 3 dan Hermes 4 adalah keluarga LLM open-weight dari lab yang sama, produk yang sepenuhnya berbeda, dan ada pula engine JavaScript tidak terkait bernama Hermes — tidak satu pun nomor versinya berlaku di sini. Dan Ollama lokal bukan Ollama Cloud: Hermes mengakses runtime lokal gratis pada port 11434 melalui alur Custom Endpoint, sedangkan Ollama Cloud adalah produk berbayar terpisah yang diimplementasikan sebagai slug provider tersendiri dengan file cache-nya sendiri. Model yang hilang pada salah satunya tidak memberi informasi apa pun tentang yang lain.

Tiga lapisan harus selaras, dan hanya satu di antaranya yang merupakan Ollama

"Model tidak ada di picker" adalah pernyataan tentang lapisan terakhir dari tiga lapisan, dan diagnosisnya adalah menemukan lapisan pertama yang tidak selaras.

# 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'

Satu hal yang perlu disingkirkan pada lapisan pertama: ollama list mencakup model embedding, dan model embedding bukan model chat yang dapat dipilih oleh agent coding. Kunavo juga tidak menyediakan model embedding, text-to-speech, atau speech-to-text, jadi itu bukan kekurangan yang dapat ditutup oleh rute ter-host di sini.

Periksa versi Anda terlebih dahulu, dan baca dengan saksama

Issue #112898 — "daftar model Ollama lokal berkedip di picker" — ditutup sebagai selesai, dibuka pada 16 September 2026 dan ditutup pada 17 September 2026. Pull request #113129 menggabungkan perbaikan sebagai commit d6d6565, dan perbandingan GitHub menempatkan commit tersebut di dalam tag v2026.9.21 dan di luar v2026.9.14: membandingkan v2026.9.21…d6d6565 menghasilkan status behind dengan nol commit di depan, sehingga commit tersebut merupakan ancestor dari tag itu, sedangkan v2026.9.14…d6d6565 menghasilkan status ahead dengan nol di belakang, sehingga tag tersebut merupakan ancestor dari commit, bukan sebaliknya. #112900 milik kontributor sendiri masih terbuka, yang bukan tanda bahwa perbaikannya tidak ada dalam main: isinya di-cherry-pick dengan kepengarangan ke dalam pull request yang digabungkan. Semua status dibaca dari GitHub API pada 21 September 2026.

Sekarang jebakannya. Dua nomor versi berbeda ada di dalam tag tersebut: pada v2026.9.21, pyproject.toml membaca version = "0.21.4", sedangkan apps/desktop/package.json membaca "version": "0.17.6". Oleh karena itu, laporan bug berjudul "Hermes Desktop 0.17.6" sebenarnya menjelaskan build terkini, bukan build lama — dan menganggap laporan seperti itu sudah kedaluwarsa akan membuat bukti Anda sendiri salah diberi tanggal. Perhatikan juga batas pemeriksaan versi ini: yang diperiksa adalah containment git dalam sebuah tag. Apakah rilis pip, formula Homebrew, image container, atau kanal pembaruan otomatis desktop yang benar-benar Anda instal memuat commit tersebut, tidak diverifikasi di sini.

Lima penyebab, dan petunjuk yang membedakannya

Dua di antaranya layak mendapat kalimat tersendiri. Pembekuan desktop adalah hal yang paling mungkin disalahartikan sebagai masalah cache: saat membaca apps/desktop/src/store/model-visibility.ts pada tag v2026.9.21, setelah sebuah provider memiliki kunci tersimpan, renderer sepenuhnya melewati penggabungan default provider, sehingga model yang ditemukan kemudian tidak pernah masuk ke menu. Issue #114369 mereproduksi hal tersebut secara tepat pada provider khusus dengan discover_models: true dan ditutup sebagai duplikat, bukan sebagai perbaikan; reproduksinya menggunakan endpoint vLLM, jadi anggap mekanismenya tidak bergantung pada provider tertentu, bukan sebagai reproduksi Ollama. Dua lainnya masih terbuka dan belum terselesaikan: #89874 (nol model untuk provider Ollama khusus, dengan label needs-repro, sehingga merupakan laporan yang belum terkonfirmasi, bukan cacat yang telah ditetapkan) dan #71169 (model ada di API Ollama, tetapi tidak ada di dropdown desktop). Belum ditetapkan apakah salah satunya memiliki akar masalah yang sama dengan #112898.

Gejala desktop juga lebih tegas daripada yang diperkirakan orang. Dalam model-catalog-menu.tsx pada tag tersebut, provider yang daftar keluarganya setelah dilipat kosong akan dilewati sepenuhnya — itulah sebabnya keluhannya biasanya "provider saya menghilang", bukan "provider saya menampilkan daftar kosong".

Mengapa pembukaan pemilih biasa menampilkan daftar yang kedaluwarsa

Inilah mekanisme di balik seluruh kelas kegagalan ini, dan perlu dipahami sekali. Saat pemilih dibuka biasa, hanya endpoint khusus saat ini yang diprobe secara live; setiap endpoint terkonfigurasi lainnya dijawab dari cache disk di $HERMES_HOME/provider_models_cache.json. HERMES_HOME secara default bernilai ~/.hermes, tetapi dapat ditimpa, jadi jangan mengasumsikan path tersebut. Tiga jendela di hermes_cli pada tag v2026.9.21 mengatur pemeriksaan ulang:

Ini adalah konstanta internal dari source, bukan pengaturan yang terdokumentasi; dalam pemeriksaan ini tidak ditemukan kontrol yang terlihat oleh pengguna untuk ketiganya. Ada satu pengecualian yang disengaja dalam kode tersebut yang perlu diketahui: katalog native yang kosong hanya dianggap otoritatif selama TTL singkat dan tidak pernah disajikan saat kedaluwarsa, tepat agar Ollama yang tidak memiliki model saat pertama kali dibuka tidak menyembunyikan model yang baru diambil selama seluruh jendela tujuh hari. Baris cache dikunci berdasarkan URL yang dinormalisasi ditambah fingerprint kredensial, mode API, dan header tambahan, karena beberapa baris provider secara sah dapat berbagi satu URL proxy dengan kunci yang berbeda. Konsekuensi praktisnya: mengganti kunci, mengubah transport, atau mengedit extra_headers akan membatalkan entri cache baris tersebut, dan pembukaan berikutnya tanpa probe akan menampilkannya kosong sampai ada sesuatu yang menyegarkannya.

Pemeriksaan, secara berurutan

1. Pastikan Ollama memilikinya. Jalankan dua curl di atas. Jika /api/tags tidak mencantumkan model tersebut, tidak ada langkah berikutnya yang dapat melakukannya.
2. Pastikan versinya. Jika Anda menggunakan build yang lebih lama dari tag v2026.9.21 dan gejalanya adalah daftar yang berkedip antara benar dan kosong, Anda sedang melihat bug yang sudah diperbaiki — lakukan upgrade sebelum men-debug.
3. Paksa penyegaran. Flag --refresh pada hermes model menyatakan dalam teks bantuannya sendiri bahwa flag tersebut menghapus cache disk pemilih dan mengambil ulang daftar live setiap provider; perhatikan bahwa flag ini menghapus cache setiap provider, bukan hanya satu. Dalam sesi, referensi slash-command mendokumentasikan /model --refresh sebagai pengambilan ulang daftar model provider, dan desktop memiliki kontrol "Refresh Models" khusus yang meminta katalog baru, sedangkan pembukaan biasa tetap menggunakan cache satu jam.
4. Periksa jalur probe yang diterapkan pada endpoint Anda. Cabang native /api/tags digunakan ketika provider bernama ollama, ketika namanya adalah custom:ollama atau diakhiri dengan -ollama, ketika URL cocok dengan URL dasar Ollama yang dikonfigurasi, atau ketika URL khusus yang ambigu di port 11434 benar-benar menjawab /api/tags. Ollama yang disajikan pada port lain dengan nama custom biasa akan beralih ke probe generik /v1/models — demikian yang dibaca dari jalur kode, dan ini tidak dijalankan di sini untuk mengonfirmasi bahwa fallback tersebut berfungsi dalam praktik.
5. Jika masalahnya adalah discovery itu sendiri, hentikan discovery. discover_models secara default bernilai true; mengaturnya ke false membuat pemilih menampilkan daftar yang Anda konfigurasikan, bukan hasil probe live.
6. Jika hanya menu desktop yang salah, kemungkinan besar Anda berada dalam kasus #107391, yang tidak dapat dihapus oleh penyegaran apa pun — backend mengembalikan modelnya, tetapi lapisan kurasi renderer membuangnya.

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

Satu detail konfigurasi berulang kali menjebak orang, dan layak dibereskan. Referensi mendokumentasikan api sebagai kunci URL dasar untuk entri providers:, dan daftar field untuk entri tersebut menyebut base_url dan url sebagai alias yang diterima untuknya; base_url secara terpisah adalah kunci dalam pemetaan tingkat atas model:. Referensi itu juga mencatat bahwa konfigurasi lama menggunakan daftar custom_providers: tingkat atas dengan base_url alih-alih api, yang masih berfungsi dan dimigrasikan otomatis pada hermes update di config v12. Laporan bug di tracker ditulis dengan kedua bentuk tersebut, seperti yang diharapkan ketika keduanya dibaca. Jadi entri providers: yang tidak berlaku kemungkinan kecil gagal karena nama kunci ini — periksa endpoint dan field lain pada entri tersebut.

Ada detail terpisah yang perlu disebutkan: halaman Hermes milik Ollama memandu prompt penyiapan sebagai "Context length in tokens [leave blank for auto-detect]", sedangkan dokumentasi provider Hermes mewajibkan setidaknya 64.000 token untuk penggunaan agent dan menyatakan bahwa endpoint lokal yang menyajikan lebih sedikit akan ditolak saat startup. Keduanya diperiksa pada 21 September 2026. Membiarkan field kosong tidak otomatis salah, tetapi tidak menyelesaikan server yang hanya menyajikan jendela kecil — jadi naikkan jendela pada server (atau tetapkan di konfigurasi Hermes) ke angka Hermes, dan ingat bahwa kegagalan ini menghasilkan penolakan saat startup yang menyebutkan jendela yang disajikan, bukan baris pemilih yang hilang.

Verifikasi, lalu putuskan apakah lokal layak digunakan

Setelah perubahan, lakukan tiga hal secara berurutan: buka kembali pemilih tanpa --refresh dan pastikan model tercantum pada pembukaan dingin, pilih model tersebut, lalu kirim satu permintaan terbatas yang mengembalikan completion. Langkah tengah penting karena daftar yang hanya benar segera setelah probe adalah ciri bug cache, bukan perbaikan. Ini adalah instruksi untuk Anda jalankan — tidak ada instalasi Hermes, instance Ollama, atau pemilih yang digunakan saat menulis halaman ini.

Jika jawabannya adalah bahwa lokal tidak sepadan dengan kerepotannya untuk tugas ini, pertanyaan biaya terbagi jelas menjadi dua: biaya perangkat lunak, dan biaya penggunaan model.

Tingkat Pro Ollama Cloud juga tercantum seharga $200 per tahun dengan penagihan tahunan, dan paketnya mencakup kredit penggunaan bulanan — $60 untuk Pro, $300 untuk Max, $1.000 bersama untuk Team. Semua itu berlaku untuk produk cloud, bukan endpoint lokal yang sedang Anda perbaiki.

Untuk rute berdasarkan pemakaian, berikut aritmetika token ilustratif, bukan biaya tugas yang diukur dan bukan batas tagihan. Anggap satu sesi mengirim 200.000 token input tanpa cache dan menerima 12.000 token output, tanpa pembacaan cache dan tanpa biaya alat eksternal. Tarifnya adalah harga katalog Kunavo yang berlaku per satu juta token.

Kalikan dengan jumlah sesi Anda sendiri per hari sebelum menganggapnya sebagai anggaran, dan perhatikan bahwa tarif terdaftar termurah serta biaya terendah untuk menyelesaikan tugas adalah klaim yang berbeda — model murah yang memerlukan tiga percobaan dapat berbiaya lebih besar daripada model yang hanya memerlukan satu. Jumlah katalog Kunavo adalah batas bawah penagihan, bukan batas maksimum: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream dikalikan markup yang berlaku. Lihat detail penagihan.

Rute yang unggul bergantung pada pekerjaannya. Ollama lokal unggul untuk tugas kecil, privat, atau offline tanpa biaya per permintaan, dengan perangkat keras dan minimum 64.000 token sebagai kendala sebenarnya. API vendor langsung unggul ketika Anda menggunakan model unggulan satu vendor dan menginginkan ketentuan caching serta batch miliknya. Gateway unggul ketika Anda berganti model untuk setiap tugas dan menginginkan satu kunci serta satu saldo. Langganan unggul ketika penggunaan berat harian dengan tarif tetap lebih sesuai bagi Anda daripada token berdasarkan pemakaian.

Mengarahkan Hermes ke tempat lain

Jika Anda memutuskan menambahkan endpoint ter-host di samping endpoint lokal, mekanismenya sama dengan alur provider khusus — dan ada satu batas yang perlu diketahui sebelum mencoba: menambahkan provider dilakukan melalui hermes model dan dijalankan di luar sesi, karena dalam sesi /model hanya berpindah di antara provider yang sudah dikonfigurasi dan tidak dapat menambahkan provider atau menerima kunci. Hermes Agent custom API menjelaskan bentuk entri, transport, dan rollback secara rinci; Hermes Agent pricing menjelaskan empat tagihan terpisah. Kunavo menerbitkan referensi konfigurasi, bukan pengujian kompatibilitas: Hermes belum pernah diuji saat runtime terhadap endpoint Kunavo dalam pekerjaan ini, jadi tidak ada bagian di sini yang menetapkan bahwa discovery Hermes berhasil terhadapnya. Pertahankan rute kerja Anda saat mencoba. API OpenAI-compatible Ollama menjelaskan mengapa kode klien yang sama dapat menjangkau keduanya, dan buat akun Kunavo saat Anda ingin mengisi dana untuk sebuah kunci.

Masih memilih klien alih-alih men-debug salah satunya? Alternatif Hermes Agent dan API OpenAI-compatible mencakup bidang yang lebih luas.

Pertanyaan umum

Yang diperiksa pada 21 September 2026, dan caranya: status issue dan pull request, containment tag untuk kedua perbaikan, tag rilis terbaru, serta status lisensi dan arsip repositori diperoleh dari GitHub API; konstanta cache, gating discovery, penyimpanan visibilitas desktop, string bantuan --refresh, dan kutipan dokumentasi dibaca dari source pada tag v2026.9.21; halaman harga Ollama, halaman integrasi Hermes milik Ollama, dan daftar paket Nous Portal diambil pada hari yang sama. Tidak diperiksa: apakah artefak pip, Homebrew, container, atau pembaruan otomatis desktop yang Anda instal memuat salah satu perbaikan tersebut. Tidak ada yang diuji saat runtime — tidak ada instalasi Hermes yang dijalankan, Ollama tidak dimulai, dan pemilih tidak dibuka. Tarif token Kunavo berasal dari katalog live, dan contoh dolar adalah aritmetika token ilustratif, bukan biaya tugas yang diukur.