Skip to main content
Используйте CometAPI как провайдера моделей для Hermes Agent. В этом руководстве Hermes поддерживает два пути работы с CometAPI: общий endpoint, совместимый с OpenAI, для большинства текстовых моделей и маршрут Claude через Anthropic Messages.

​
Предварительные требования

  • Git
  • Аккаунт CometAPI с активным API-ключом
  • Терминал на macOS, Linux или WSL2

​
Установка

1

Получите API-ключ CometAPI

Войдите в консоль CometAPI. Нажмите Add API Key и скопируйте свой API-ключ CometAPI.
Панель управления CometAPI с кнопкой Add API Key
Сведения об API-ключе CometAPI с показанным base URL
2

Установите Hermes Agent

Следующая команда запускает официальный установщик:
Если текущая оболочка пока не видит команду hermes, перезагрузите конфигурацию оболочки:
Hermes хранит конфигурацию в ~/.hermes/, размещает ссылку на команду hermes в ~/.local/bin и может добавить ~/.local/bin в PATH вашей оболочки.

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

Выберите маршрут CometAPI, соответствующий семейству моделей:
Не настраивайте Hermes с https://api.cometapi.com/v1beta как пользовательский Gemini-native provider. Для моделей Gemini используйте в Hermes конфигурацию, совместимую с OpenAI. Для прямых вызовов Gemini API используйте Gemini generateContent API.
1

Сохраните ваш ключ CometAPI

Откройте ~/.hermes/.env и добавьте следующие значения:
COMETAPI_KEY используется именованным provider для Claude. OPENAI_API_KEY сохраняет работоспособность резервного пользовательского endpoint Hermes, совместимого с OpenAI.
2

Настройте маршрут, совместимый с OpenAI

Используйте этот маршрут для большинства текстовых моделей CometAPI, включая модели Gemini, используемые из Hermes. Откройте ~/.hermes/config.yaml и убедитесь, что раздел model выглядит так:
Замените your-model-id на актуальный model ID текстовой модели со страницы CometAPI Models page.
Храните API key в ~/.hermes/.env. Не прописывайте секреты напрямую в config.yaml.
Эта настройка конфигурирует основную chat-модель. Hermes может использовать отдельные вспомогательные модели для таких задач, как vision или web extraction.
3

Настройте маршрут Claude Messages

Используйте этот маршрут, если хотите, чтобы Hermes вызывал модели Claude через Anthropic Messages. Откройте ~/.hermes/config.yaml и используйте именованный provider:
Замените your-claude-model-id на актуальный model ID Claude со страницы CometAPI Models page.
Для этого маршрута оставьте base_url равным https://api.cometapi.com. Hermes использует транспорт Anthropic Messages из именованного provider.

​
Проверка

1

Проверьте конфигурацию

Следующая команда подтверждает, что Hermes может прочитать конфигурацию и API key:
Если после обновления hermes config check сообщает об отсутствующих параметрах, выполните hermes config migrate и проверьте снова.
2

Запустите реальный chat-тест

Следующая команда отправляет реальный запрос через CometAPI:
При успешной настройке возвращается CONNECTED, и ошибки auth или endpoint отсутствуют. Когда активна конфигурация Claude Messages, это подтверждает, что Hermes может использовать транспорт anthropic_messages через CometAPI.

​
Необязательная конфигурация

Если вы заменяете более старую установку Hermes, сначала воспользуйтесь встроенным деинсталлятором:
В деинсталляторе выберите Full uninstall, чтобы удалить CLI, запись PATH и данные ~/.hermes/. Затем снова выполните шаг установки и продолжите с той же конфигурацией CometAPI.
Если вы предпочитаете интерактивный сценарий для OpenAI-совместимого маршрута, выполните hermes model и выберите Custom endpoint.Затем введите следующие значения:
  • Base URL: https://api.cometapi.com/v1
  • API key: ваш API key CometAPI
  • Model: текущий model ID текстовой модели CometAPI
Этот сценарий записывает настройки OpenAI-совместимого провайдера в config.yaml. Для Claude Messages отредактируйте config.yaml напрямую, чтобы именованный провайдер сохранял transport: anthropic_messages.