본문으로 건너뛰기

모델 카탈로그

Hermes는 문서 사이트와 함께 호스팅되는 JSON 매니페스트에서 OpenRouter및Nous Portal에 대한 선별된 모델 목록을 가져옵니다. 이를 통해 관리자는 새로운 hermes-agent 릴리스를 출시하지 않고도 선택기 목록을 업데이트할 수 있습니다.

매니페스트에 연결할 수 없는 경우(오프라인, 네트워크 차단, 호스팅 실패) Hermes는 자동으로 CLI와 함께 제공되는 저장소 내 스냅샷으로 대체됩니다. 매니페스트는 절대 선택기를 손상시키지 않습니다. 최악의 경우에는 설치된 버전에 번들로 포함된 목록이 표시됩니다.

라이브 매니페스트 URL​

https://hermes.dsone.my/docs/api/model-catalog.json

기존 deploy-site.yml GitHub 페이지 파이프라인을 통해 main에 병합될 때마다 게시됩니다. 정보의 출처는 website/static/api/model-catalog.json 저장소에 있습니다.

스키마​

{
  "version": 1,
  "updated_at": "2026-04-25T22:00:",
  "metadata": {},
  "providers": {
    "openrouter": {
      "metadata": {},
      "models": [
        {"id": "moonshotai/kimi-k2.6", "description": "recommended", "metadata": {}},
        {"id": "openai/gpt-5.4",       "description": ""}
      ]
    },
    "nous": {
      "metadata": {},
      "models": [
        {"id": "anthropic/claude-opus-4.7"},
        {"id": "moonshotai/kimi-k2.6"}
      ]
    }
  }
}

필드 참고사항:

  • version — 정수 스키마 버전. 미래의 스키마는 이 문제를 해결합니다. Hermes는 이해하지 못하는 버전이 포함된 매니페스트를 거부하고 하드코딩된 스냅샷으로 대체합니다.
  • metadata — 매니페스트, 제공자 및 모델 수준의 자유 형식 사전입니다. 모든 키. Hermes는 알 수 없는 필드를 무시하므로 스키마 변경을 조정하지 않고도 항목("tier": "paid", "tags": [...] 등)에 주석을 달 수 있습니다.
  • description — OpenRouter 전용. 드라이브 선택기 배지 텍스트("recommended", "free" 또는 비어 있음). Nous Portal은 이를 사용하지 않습니다. 무료 계층 게이팅은 포털의 가격 책정 엔드포인트에서 실시간으로 결정됩니다.
  • 가격 및 컨텍스트 길이는 매니페스트에 없습니다. 이는 가져오기 시 라이브 제공자 API(/v1/models 엔드포인트, models.dev)에서 제공됩니다.

가져오기 동작​

언제무슨 일이 일어나는가
/model 또는 hermes model디스크 캐시가 오래되면 가져오고 그렇지 않으면 캐시를 사용합니다.
디스크 캐시 신규(< TTL)네트워크 적중 없음
캐시로 인한 네트워크 오류캐시로의 자동 대체, 로그 라인 1개
네트워크 오류, 캐시 없음저장소 내 스냅샷으로 자동 대체
매니페스트가 스키마 유효성 검사에 실패함연결할 수 없는 것으로 처리됨

캐시 위치: ~/.hermes/cache/model_catalog.json.

구성​

model_catalog:
  enabled: true
  url: https://hermes.dsone.my/docs/api/model-catalog.json
  ttl_hours: 24
  providers: {}

원격 가져오기를 완전히 비활성화하고 항상 저장소 내 스냅샷을 사용하려면 enabled: false을 설정하세요.

제공자별 재정의 URL​

제3자는 동일한 스키마를 사용하여 자체 큐레이션 목록을 자체 호스팅할 수 있습니다. 맞춤 URL에서 제공자를 가리킵니다.

model_catalog:
  providers:
    openrouter:
      url: https://example.com/my-openrouter-curation.json

재정의 매니페스트는 관심 있는 제공자 블록만 채우면 됩니다. 다른 제공자는 계속해서 마스터 URL을 확인합니다.

매니페스트 업데이트​

유지관리자:

# Re-generate from the in-repo hardcoded lists (keeps manifest in sync after
# editing OPENROUTER_MODELS or _PROVIDER_MODELS["nous"] in hermes_cli/models.py).
python scripts/build_model_catalog.py

그런 다음 website/static/api/model-catalog.json에 대한 결과 변경 사항을 main에 PR합니다. 문서 사이트는 병합 시 자동으로 배포되며 새 매니페스트는 몇 분 내에 활성화됩니다.

저장소 내 스냅샷에 속하지 않는 세분화된 메타데이터 변경 사항에 대해 JSON을 직접 직접 편집할 수도 있습니다. 생성기 스크립트는 편의를 위한 것이지 단일 정보 소스가 아닙니다.