Hermes Ollama 모델이 표시되지 않음: 카탈로그 및 제공업체 점검

Ollama 모델이 Hermes 선택기에서 사라졌다면 구성을 변경하기 전에 버전을 확인하십시오. 정확히 이 증상을 일으키는 기본 카탈로그 캐시 버그는 2026년 9월 17일 완료로 종료되었으며, 수정 사항은 태그 v2026.9.21(hermes-agent 0.21.4)에는 포함되었지만 v2026.9.14에는 포함되지 않았습니다. 그러나 종료된 보고서가 전체 상황을 설명하지는 않습니다. 2026년 9월 21일 현재 선택기에서 Ollama 모델이 누락되는 추가 보고서 두 건이 아직 열려 있었고, 세 번째 열린 이슈는 표시 모델 목록이 한 번이라도 사용자 지정된 모든 공급자에서 동일한 증상을 일으키는 Hermes Desktop 메커니즘을 설명합니다. 저는 같은 태그의 배포된 소스에서도 해당 동작이 여전히 존재하는 것을 확인했습니다. 네 번째 흔한 원인은 결함이 전혀 아닙니다. 각각에는 서로 다른 징후가 있으며, 이 페이지는 그 징후를 확인하기 위한 것입니다.

검색 결과에서 서로 충돌하기 때문에 먼저 두 가지를 구분해야 합니다. Hermes Agent는 Nous Research의 Python 에이전트입니다(MIT, 아카이브되지 않음, GitHub API 기준 마지막 푸시는 2026년 9월 21일). Hermes 3 및 Hermes 4는 같은 연구소의 오픈 웨이트 LLM 제품군으로, 전혀 다른 제품이며 Hermes라는 관련 없는 JavaScript 엔진도 있습니다. 이들의 버전 번호는 여기 적용되지 않습니다. 또한 로컬 Ollama는 Ollama Cloud가 아닙니다. Hermes는 Custom Endpoint 흐름을 통해 포트 11434의 무료 로컬 런타임에 접근하는 반면, Ollama Cloud는 자체 공급자 slug와 자체 캐시 파일로 구현된 별도의 유료 제품입니다. 한쪽에서 모델이 누락되었다고 해서 다른 쪽에 대해서는 아무것도 알 수 없습니다.

세 계층이 일치해야 하며, 그중 Ollama인 것은 하나뿐입니다

"모델이 선택기에 없습니다"는 세 계층 중 마지막 계층에 대한 설명이며, 진단은 어느 계층이 처음으로 불일치하는지 찾는 일입니다.

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

첫 번째 계층에서 배제해야 할 한 가지는 ollama list에 임베딩 모델이 포함된다는 점입니다. 임베딩 모델은 코딩 에이전트가 선택할 수 있는 채팅 모델이 아닙니다. Kunavo는 임베딩, 텍스트 음성 변환 또는 음성 텍스트 변환 모델도 제공하지 않으므로, 호스팅 경로로 해결되는 누락이 아닙니다.

먼저 버전을 확인하고 주의 깊게 읽으십시오

이슈 #112898 — "선택기에서 로컬 Ollama 모델 목록이 깜박임" — 은 완료로 종료되었습니다. 2026년 9월 16일에 열렸고 2026년 9월 17일에 종료되었습니다. 풀 리퀘스트 #113129는 커밋 d6d6565으로 수정 사항을 병합했으며, GitHub 비교 결과 해당 커밋은 태그 v2026.9.21 안에 있고 v2026.9.14 밖에 있습니다. v2026.9.21…d6d6565을 비교하면 상태가 behind이고 앞선 커밋은 0개이므로 해당 커밋은 그 태그의 조상입니다. 반면 v2026.9.14…d6d6565은 상태가 ahead이고 뒤처진 커밋은 0개이므로 태그가 커밋의 조상이며 반대가 아닙니다. 기여자의 자체 #112900은 여전히 열려 있지만, 이는 수정 사항이 main에 없다는 뜻이 아닙니다. 해당 내용은 작성자 정보를 유지한 채 병합된 풀 리퀘스트에 체리픽되었습니다. 모든 상태는 2026년 9월 21일 GitHub API에서 읽었습니다.

여기서 함정이 있습니다. 하나의 태그 안에 서로 다른 두 버전 번호가 포함되어 있습니다. v2026.9.21에서 pyproject.toml은 version = "0.21.4"로 읽히고 apps/desktop/package.json은 "version": "0.17.6"로 읽힙니다. 따라서 "Hermes Desktop 0.17.6"이라는 제목의 버그 보고서는 오래된 빌드가 아니라 현재 빌드를 설명하는 것입니다. 이러한 보고서를 오래된 것으로 치부하면 자체 증거의 날짜를 잘못 판단하게 됩니다. 버전 확인의 한계도 유의하십시오. 이는 태그에서의 git 포함 관계입니다. 실제로 설치한 pip 릴리스, Homebrew formula, 컨테이너 이미지 또는 데스크톱 자동 업데이트 채널에 해당 커밋이 포함되어 있는지는 여기서 확인하지 않았습니다.

다섯 가지 원인과 이를 구분하는 징후

이 중 두 가지는 별도의 문장으로 설명할 가치가 있습니다. 데스크톱 고정은 캐시 문제로 오해하기 가장 쉽습니다. 태그 v2026.9.21의 apps/desktop/src/store/model-visibility.ts를 읽어 보면, 공급자에 저장된 키가 하나라도 있을 때 렌더러는 공급자 기본값 병합을 완전히 건너뛰므로 나중에 검색된 모델이 메뉴에 들어가지 않습니다. 이슈 #114369는 discover_models: true인 사용자 지정 공급자에서 정확히 이를 재현했으며 수정된 것이 아니라 중복 이슈로 종료되었습니다. 재현에는 vLLM 엔드포인트가 사용되었으므로 이 메커니즘을 Ollama 재현 사례가 아니라 공급자에 무관한 메커니즘으로 간주하십시오. 두 가지가 더 열려 있고 해결되지 않은 상태입니다. #89874는 사용자 지정 Ollama 공급자에서 모델이 0개인 문제로 needs-repro 레이블이 붙어 있어 확인되지 않은 보고서이지 확정된 결함은 아닙니다. #71169은 Ollama API에는 모델이 존재하지만 데스크톱 드롭다운에는 없는 문제입니다. 어느 쪽이든 #112898과 근본 원인을 공유하는지는 확립되지 않았습니다.

데스크톱 증상은 사람들이 예상하는 것보다 더 뚜렷합니다. 해당 태그의 model-catalog-menu.tsx에서 접힌 제품군 목록이 비어 있는 공급자는 완전히 건너뜁니다. 그래서 불만은 대개 "공급자가 빈 목록으로 표시된다"가 아니라 "공급자가 사라졌다"입니다.

일반적인 선택기 열기에서 오래된 목록이 표시되는 이유

이것이 전체 장애 유형의 근본 메커니즘이며 한 번은 이해해 둘 가치가 있습니다. 일반적인 선택기를 열면 현재 사용자 지정 엔드포인트만 실시간으로 조회하고, 구성된 다른 모든 엔드포인트는 $HERMES_HOME/provider_models_cache.json의 디스크 캐시에서 응답합니다. HERMES_HOME의 기본값은 ~/.hermes이지만 재정의할 수 있으므로 경로를 가정하지 마십시오. 태그 v2026.9.21의 hermes_cli에는 재조회 시점을 결정하는 세 가지 기간이 있습니다.

이는 문서화된 설정이 아니라 내부 소스 상수입니다. 이번 확인에서는 이 세 항목을 위한 사용자용 조절 옵션을 찾지 못했습니다. 해당 코드의 한 가지 의도적인 예외는 알아둘 필요가 있습니다. 비어 있는 네이티브 카탈로그는 짧은 TTL 내에서만 유효한 결과로 간주되며, 만료된 뒤에는 절대 제공되지 않습니다. 이는 처음 열었을 때 모델이 없었던 Ollama가 새로 가져온 모델을 7일 전체 동안 숨기지 않도록 하기 위한 것입니다. 또한 캐시 행은 정규화된 URL 과 자격 증명, API 모드 및 추가 헤더의 지문을 함께 사용해 키가 지정됩니다. 여러 공급자 행이 서로 다른 키를 사용하면서 하나의 프록시 URL을 공유하는 것이 정상적인 구성일 수 있기 때문입니다. 실질적인 결과는 키를 교체하거나 전송 방식을 변경하거나 extra_headers를 편집하면 해당 행의 캐시 항목이 무효화되고, 다음 프로브 없는 열기에서는 무언가가 해당 캐시 항목을 새로 고칠 때까지 그 행이 비어 있게 표시된다는 것입니다.

순서대로 수행할 확인

1. Ollama에 모델이 있는지 확인하십시오. 위의 두 curl을 실행하십시오. /api/tags에 모델이 나열되지 않으면 그 아래 계층에서도 나열될 수 없습니다.
2. 버전을 확인하십시오. 태그 v2026.9.21보다 오래된 빌드를 사용 중이고 증상이 올바른 목록과 빈 목록 사이를 깜박이는 것이라면, 이미 수정된 버그를 보고 있는 것입니다. 디버깅하기 전에 업그레이드하십시오.
3. 강제로 새로 고치십시오. hermes model의 --refresh 플래그는 자체 도움말에서 선택기 디스크 캐시를 삭제하고 모든 공급자의 실시간 목록을 다시 가져온다고 설명합니다. 하나가 아니라 모든 공급자를 지운다는 점에 유의하십시오. 세션 내에서 슬래시 명령 참고 문서는 /model --refresh가 공급자의 모델 목록을 다시 가져온다고 설명하며, 데스크톱에는 새 카탈로그를 요청하는 명시적인 "Refresh Models" 컨트롤이 있습니다. 일반적인 열기에서는 1시간 캐시를 계속 사용합니다.
4. 엔드포인트에 적용되는 조회 경로를 확인하십시오. 공급자 이름이 ollama이거나 이름이 custom:ollama이거나 -ollama로 끝나는 경우, URL이 구성된 Ollama 기본 URL과 일치하는 경우, 또는 포트 11434에서 모호한 사용자 지정 URL이 실제로 /api/tags에 응답하는 경우 기본 /api/tags 경로가 사용됩니다. 일반적인 custom 이름으로 다른 포트에서 제공되는 Ollama는 대신 일반적인 /v1/models 조회로 넘어갑니다. 코드 경로는 그렇게 동작하는 것으로 읽히지만, 폴백이 실제로 작동하는지는 여기서 실행해 확인하지 않았습니다.
5. 발견 자체가 문제라면 발견을 중단하세요. discover_models의 기본값은 true입니다. 이를 false로 설정하면 실시간 탐색 대신 구성한 목록이 선택기에 표시됩니다.
6. 데스크톱 메뉴만 잘못된 경우 새로 고침으로 해결되지 않는 #107391 상황일 가능성이 큽니다. 백엔드는 모델을 반환하지만 렌더러의 큐레이션 계층에서 모델이 제거됩니다.

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

사람들이 반복해서 혼동하는 설정 세부 사항이 하나 있으므로, 명확히 짚고 넘어갈 필요가 있습니다. 참조 문서에서는 providers: 항목의 기본 URL 키를 api로 명시하고 있으며, 해당 항목의 필드 목록에는 base_url와 url도 이 키의 별칭으로 허용된다고 나와 있습니다. 이와 별개로 base_url는 최상위 model: 매핑 아래의 키입니다. 또한 이전 설정에서는 최상위 custom_providers: 목록을 사용하면서 api 대신 base_url를 사용했으며, 이 방식은 여전히 작동하고 설정 버전 v12에서 hermes update 실행 시 자동으로 마이그레이션된다고 기록되어 있습니다. 이슈 트래커의 버그 보고서에는 두 표기 방식이 모두 사용되는데, 두 방식 모두 읽어 들일 수 있으므로 이는 예상할 수 있는 일입니다. 따라서 providers: 항목이 적용되지 않는다면 이 키의 이름 때문에 실패했을 가능성은 낮습니다. 엔드포인트와 해당 항목의 다른 필드를 확인하세요.

별도로 짚어둘 만한 세부 사항이 있습니다. Ollama 자체의 Hermes 페이지는 설정 프롬프트를 "Context length in tokens [leave blank for auto-detect]"로 안내하는 반면, Hermes의 공급자 문서는 에이전트 사용에 최소 64,000 토큰이 필요하며 그보다 적은 값을 제공하는 로컬 엔드포인트는 시작 시 거부된다고 명시합니다. 두 문서 모두 2026년 9월 21일에 확인했습니다. 필드를 비워 두는 것 자체는 잘못이 아니지만, 작은 윈도우만 제공하는 서버 문제는 해결하지 못합니다. 따라서 서버에서 윈도우를 Hermes가 요구하는 값으로 늘리거나 Hermes 구성에서 그 값으로 고정하고, 이 실패는 선택기 행 누락이 아니라 제공된 윈도우를 명시하는 시작 거부로 나타난다는 점을 기억하세요.

확인한 후 로컬 사용이 가치 있는지 결정하세요

변경 후 다음 세 가지를 순서대로 수행하세요. --refresh 없이 선택기를 다시 열고 콜드 오픈 시 모델이 목록에 표시되는지 확인한 다음, 모델을 선택하고 완료를 반환하는 제한된 요청을 하나 전송하세요. 중간 단계가 중요한 이유는 프로브 직후에만 올바른 목록이 표시된다면 이는 수정이 아니라 캐시 버그의 징후이기 때문입니다. 이는 실행할 지침이며, 이 페이지를 작성하는 동안 Hermes 설치, Ollama 인스턴스 또는 선택기는 실행하지 않았습니다.

이 작업에서는 로컬 사용이 번거로움을 감수할 가치가 없다는 결론이라면, 비용 문제는 두 가지로 명확히 나뉩니다. 소프트웨어 비용과 모델 사용량 비용입니다.

Ollama Cloud의 Pro 티어는 연간 청구 기준으로 연 $200로도 표시되며, 각 요금제에는 월간 사용 크레딧이 포함됩니다. Pro는 $60, Max는 $300, Team은 공유 기준 $1,000입니다. 이는 클라우드 제품에 해당하며, 수정 중인 로컬 엔드포인트에는 해당하지 않습니다.

미터링 방식의 경우 다음은 측정된 작업 비용도, 청구 상한도 아닌 예시 토큰 계산입니다. 캐시되지 않은 입력 토큰 200,000개를 보내고 출력 토큰 12,000개를 받으며, 캐시 읽기와 외부 도구 요금은 없다고 가정하세요. 요금은 백만 토큰당 Kunavo 카탈로그의 현재 가격입니다.

이를 예산으로 간주하기 전에 자신의 일일 세션 수를 곱해 보세요. 또한 가장 저렴하게 표시된 요금과 작업을 완료하는 데 드는 최저 비용은 서로 다른 주장입니다. 세 번 시도해야 하는 저렴한 모델이 한 번만 시도하면 되는 모델보다 비용이 더 들 수 있습니다. Kunavo 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림에서 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 적용한 금액 중 더 큰 값입니다. 청구 세부 정보를 참조하세요.

어느 경로가 더 나은지는 작업에 따라 달라집니다. 로컬 Ollama는 요청별 요금 없이 소규모·비공개·오프라인 작업에 적합하며, 실제 제약 조건은 하드웨어와 64,000토큰 최소 한도입니다. 직접 공급자 API는 한 공급자의 주력 모델을 주로 사용하고 해당 공급자의 캐시 및 배치 조건을 이용하려 할 때 적합합니다. 게이트웨이는 작업마다 모델을 바꾸고 하나의 키와 잔액을 사용하려 할 때 적합합니다. 구독은 토큰별 과금보다 정액제의 높은 일일 사용량이 더 적합할 때 유리합니다.

Hermes를 다른 곳으로 연결하기

로컬 엔드포인트 옆에 호스팅된 엔드포인트를 추가하기로 했다면 메커니즘은 동일한 사용자 지정 공급자 흐름입니다. 다만 시도하기 전에 알아둘 경계가 하나 있습니다. 공급자 추가는 hermes model를 세션 외부에서 실행할 때 이루어집니다. 세션 내 /model는 이미 구성된 공급자 사이를 전환할 뿐, 공급자를 추가하거나 키를 받지 못합니다. Hermes Agent 사용자 지정 API는 항목 형식, 전송 방식 및 롤백을 자세히 설명하며, Hermes Agent 요금은 네 가지 별도 청구를 설명합니다. Kunavo는 호환성 테스트가 아니라 구성 참조를 제공합니다. 이 작업에서는 Hermes를 Kunavo 엔드포인트에 대해 런타임 테스트한 적이 없으므로 Hermes의 검색이 해당 엔드포인트에서 성공한다고 보장하는 내용은 없습니다. 시도하는 동안 현재 사용 중인 경로를 유지하세요. Ollama의 OpenAI 호환 API는 동일한 클라이언트 코드가 두 엔드포인트 모두에 연결되는 이유를 설명하며, 키에 자금을 충전하려면 Kunavo 계정을 생성하세요.

여전히 하나를 디버깅하기보다 클라이언트를 선택하고 있나요? Hermes Agent 대안과 OpenAI 호환 API에서 더 넓은 선택지를 다룹니다.

자주 묻는 질문

2026년 9월 21일에 확인한 항목과 방법은 다음과 같습니다. 이슈 및 풀 리퀘스트 상태, 두 수정 사항의 태그 포함 여부, 최신 릴리스 태그, 저장소의 라이선스 및 보관 상태는 GitHub API에서 확인했습니다. 캐시 상수, 검색 게이팅, 데스크톱 표시 상태 저장소, --refresh 도움말 문자열 및 문서 인용문은 v2026.9.21 태그의 소스에서 읽었습니다. Ollama 요금 페이지, Ollama 자체의 Hermes 통합 페이지 및 Nous Portal 요금제 목록도 같은 날 가져왔습니다. 확인하지 않은 사항은 설치한 pip, Homebrew, 컨테이너 또는 데스크톱 자동 업데이트 아티팩트에 어느 수정 사항이 포함되어 있는지입니다. 이 내용은 런타임 테스트를 거치지 않았습니다. 설치된 Hermes를 실행하지 않았고, Ollama를 시작하지 않았으며, 선택기를 열지 않았습니다. Kunavo 토큰 요금은 실시간 카탈로그에서 가져왔으며, 달러 예시는 측정된 작업 비용이 아니라 예시 토큰 계산입니다.