Hermes agent

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

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

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

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

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

Публикуется при каждом слиянии в main через существующий пайплайн GitHub Pages deploy-site.yml. Источник истины находится в репозитории по адресу 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 не использует это поле — ограничения бесплатного уровня определяются в реальном времени из ценового эндпоинта Portal.
  • Цены и длина контекста НЕ включены в манифест. Они поступают из живых API провайдеров (эндпоинты /v1/models, models.dev) во время загрузки.

Поведение при загрузке

КогдаЧто происходит
/model или hermes modelЗагружает, если кэш на диске устарел, иначе использует кэш
Кэш на диске свежий (< TTL)Нет обращений к сети
Сбой сети при наличии кэшаМолчаливый откат к кэшу, одна строка в логе
Сбой сети, кэш отсутствуетМолчаливый откат к встроенному снимку
Манифест не прошёл валидацию схемыСчитается недоступным

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

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

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

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

URL переопределения для конкретного провайдера

Третьи стороны могут самостоятельно размещать свой кураторский список, используя ту же схему. Укажите провайдеру пользовательский URL:

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

Переопределяющий манифест должен заполнять только нужный блок провайдера. Остальные провайдеры продолжают разрешаться через основной URL.

Обновление манифеста

Для сопровождающих:

# Перегенерировать из встроенных жёстко заданных списков (синхронизирует манифест после
# редактирования OPENROUTER_MODELS или _PROVIDER_MODELS["nous"] в hermes_cli/models.py).
python scripts/build_model_catalog.py

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

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

⌕ ESC