Перейти к основному содержанию
Используйте CometAPI как провайдера моделей для Hermes Agent через поддержку пользовательских OpenAI-совместимых endpoint в Hermes.

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

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

Установка

1

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

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

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

Следующая команда запускает официальный установщик:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Если текущая оболочка пока не видит команду hermes, перезагрузите конфигурацию оболочки:
source ~/.zshrc
# or
source ~/.bashrc
Hermes хранит конфигурацию в ~/.hermes/, размещает ссылку на команду hermes в ~/.local/bin и может добавить ~/.local/bin в PATH вашей оболочки.

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

1

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

Откройте ~/.hermes/.env и добавьте следующую строку:
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes использует OPENAI_API_KEY как резервный параметр аутентификации для пользовательских OpenAI-совместимых endpoint.
2

Настройте endpoint CometAPI

Откройте ~/.hermes/config.yaml и убедитесь, что раздел model выглядит так:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
Замените your-model-id на актуальный model ID текстовой модели со страницы CometAPI Models.
Храните API-ключ в ~/.hermes/.env. Не прописывайте секреты прямо в config.yaml.
Эта настройка задаёт основную модель для чата. Hermes может использовать отдельные вспомогательные модели для таких задач, как vision или извлечение данных из веб-страниц.

Проверка

1

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

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

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

Следующая команда отправляет реальный запрос через CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
При успешной настройке возвращается CONNECTED без ошибок аутентификации или endpoint.

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

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