Skip to main content
Використовуйте CometAPI як провайдера model для Hermes Agent. У цьому посібнику Hermes підтримує два шляхи CometAPI: загальний OpenAI-compatible endpoint для більшості текстових моделей і маршрут Claude через Anthropic Messages.

​
Передумови

  • Git
  • Обліковий запис CometAPI з активним API key
  • Термінал у macOS, Linux або WSL2

​
Встановлення

1

Отримайте свій CometAPI API key

Увійдіть у консоль CometAPI. Натисніть Add API Key і скопіюйте свій CometAPI API key.
Панель керування CometAPI з кнопкою Add API Key
Деталі API key CometAPI з показаним base URL
2

Встановіть Hermes Agent

Наступна команда запускає офіційний інсталятор:
Якщо поточна оболонка ще не бачить команду hermes, перезавантажте конфігурацію оболонки:
Hermes зберігає config у ~/.hermes/, розміщує посилання на команду hermes у ~/.local/bin і може додати ~/.local/bin до PATH вашої оболонки.

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

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

Збережіть свій ключ CometAPI

Відкрийте ~/.hermes/.env і додайте такі значення:
COMETAPI_KEY використовується іменованим provider для Claude. OPENAI_API_KEY забезпечує роботу резервного кастомного OpenAI-compatible endpoint у Hermes.
2

Налаштуйте OpenAI-compatible маршрут

Використовуйте цей маршрут для більшості текстових моделей CometAPI, зокрема моделей Gemini, які використовуються з Hermes. Відкрийте ~/.hermes/config.yaml і переконайтеся, що розділ model має такий вигляд:
Замініть your-model-id на актуальний model ID текстової моделі зі сторінки моделей CometAPI.
Зберігайте 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.
Для цього маршруту залишайте 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-сумісного provider у config.yaml. Для Claude Messages відредагуйте config.yaml безпосередньо, щоб іменований provider зберігав transport: anthropic_messages.