sidebar_position: 11 title: Model Catalog description: Remotely-hosted manifest driving curated model picker lists for OpenRouter and Nous Portal. lang: ru

Каталог моделей

Hermes извлекает тщательно подобранные списки моделей для OpenRouter и Nous Portal из манифеста JSON, размещенного рядом с сайтом документации. Это позволяет разработчикам обновлять списки выбора без выпуска новой версии hermes-agent.

Когда манифест недоступен (автономно, сеть заблокирована, сбой хостинга), Hermes автоматически возвращается к снимку в репозитории, который поставляется с CLI. Манифест никогда не нарушает работу средства выбора — в худшем случае вы увидите список, включенный в установленную версию.

URL-адрес живого манифеста

https://hermes-agent.nousresearch.com/docs/api/model-catalog.json

Публикуется при каждом слиянии с main через существующий конвейер deploy-site.yml GitHub Pages. Источник истины живет в репозитории по адресу website/static/api/model-catalog.json.

Схема

{
  "version": 1,
  "updated_at": "2026-04-25T22:00:00Z",
  "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 endpoints, models.dev) во время выборки.

Получение поведения

Местоположение кэша: ~/.hermes/cache/model_catalog.json.

Конфигурация

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

Установите enabled: false, чтобы полностью отключить удаленную выборку и всегда использовать моментальный снимок в репозитории.

URL-адреса переопределения для каждого поставщика

Третьи лица могут самостоятельно размещать свой собственный список кураторов, используя ту же схему. Укажите поставщику пользовательский 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

Затем PR полученное изменение с website/static/api/model-catalog.json на main. Сайт документации автоматически развертывается при слиянии, и новый манифест становится доступным в течение нескольких минут.

Вы также можете вручную редактировать JSON напрямую для детальных изменений метаданных, которые не входят в снимок в репозитории — сценарий генератора — это удобство, а не единственный источник истины.