ai2saveai2save

Hermes Agent Руководство по настройке

Модель Hermes Agent, поставщики и настраиваемые endpoint сохраняются в ~/.hermes/config.yaml; чувствительная информация, такая как API Key, хранится в ~/.hermes/.env. ai2save использует интерфейс OpenAI Compatible, а Base URL — это https://ai2save.com/v1.

1. Создание API Key

  1. Откройте https://ai2save.com/keys.
  2. Создайте ключ и выберите группу, содержащую целевую модель.
  3. Скопируйте полный sk-... ключ.
  4. Запишите в консоли отображаемый реальный ID модели, например gpt-5.5.

2. Рекомендовано использовать встроенный мастер

Выполните в терминале:

hermes model

Выберите согласно подсказке:

Custom endpoint (self-hosted / vLLM / etc.)

Введите по очереди:

API base URL: https://ai2save.com/v1
API key: sk-ваш-api-ключ
Model name: gpt-5.5

Гид запишет эти значения в ~/.hermes/config.yaml. Не записывайте Base URL в .env; официальное соглашение Hermes о конфигурации endpoint модели исходит из config.yaml.

3. Ручное редактирование конфигурационного файла

Редактируйте ~/.hermes/config.yaml:

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

Описание полей:

  • provider: custom: Используйте любой OpenAI Compatible endpoint.
  • default: ID модели по умолчанию, должен полностью совпадать с ID модели, открытой в консоли.
  • base_url: Должен идти вместе с /v1, Hermes на основе этого сделает запрос /chat/completions.
  • key_env: Указывает имя переменной окружения, в которой хранится ключ.

Редактировать ~/.hermes/.env:

AI2SAVE_API_KEY=sk-ваш-api-ключ

.env сохраняет конфиденциальную информацию, config.yaml сохраняет неконфиденциальные настройки модели. Не отправляйте .env в Git.

4. Запись с помощью команды конфигурации

Также можно использовать встроенные команды Hermes, чтобы избежать ошибок YAML с отступами:

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-ваш-api-ключ
hermes config check

AI2SAVE_API_KEY — это имя переменной окружения в верхнем регистре, Hermes автоматически запишет ~/.hermes/.env.

5. Перезапуск и проверка

  1. Полностью выйдите из текущей сессии Hermes или Gateway.
  2. Перезапустите Hermes.
  3. Создайте новую сессию и отправьте короткий вопрос.
  4. Введите в сессии /model, чтобы подтвердить, что текущая модель — custom/gpt-5.5 или gpt-5.5.

Временное использование указанной модели:

hermes chat --provider custom --model gpt-5.5

Рекомендуется при первой проверке отключить параллельные задачи и сложные инструменты, отправлять только короткие тексты. После аутентификации и подключения модели постепенно включать инструменты terminal, web, file и др.

6. Частые ошибки

  • 401 / invalid_api_key: AI2SAVE_API_KEY не существует или значение неполное. Выполните проверку ссылки hermes config get model.key_env.
  • 404 / model not found: model.default не является настоящим ID модели, доступной в консоли.
  • Сбой соединения: base_url должен быть https://ai2save.com/v1; не пишите как https://ai2save.com.
  • Конфигурация не применена: устаревший OPENAI_BASE_URL влияет только на openai-api Provider, не применяется автоматически к custom; проверьте config.yaml для model.base_url.
  • Ошибка разбора YAML: не должно быть повторяющихся блоков model:, объедините все поля в одном блоке.
  • Аномалия вызова инструмента: сначала убедитесь, что модель поддерживает tool calling, и установите базовые запросы короткими текстами, затем включайте набор инструментов.