Google Близнецы

Агент Hermes поддерживает Google Gemini в качестве собственного провайдера, используя Google AI Studio/Gemini API — конечную точку, несовместимую с OpenAI. Это Hermes преобразовывает свой внутренний цикл сообщений и инструментов, ориентированных на OpenAI, в собственном API Gemini generateContent, сохраняя при этом вызове инструменты, потоковую передачу, мультимодальные входные данные и метаданные ответы, специально для Gemini.

Hermes также поддерживает отдельного провайдера Google Gemini (OAuth), который использует тот же бэкенд Cloud Code Assist, что и CLI Gemini от Google. Используйте провайдера с API-ключом («gemini») для исключения риска государственного пути API.

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

• API-ключ Google AI Studio — создайте на aistudio.google.com/apikey
• Проект Google Cloud с включенным биллингом — рекомендуется для использования агентом. Бесплатный тариф Gemini слишком мал для длительных сеансов агента, поскольку Hermes может выполнять несколько моделей вызовов за один шаг пользователя.
• Установленный Hermes — для родного провайдера Gemini не требуется дополнительный пакет Python.

  💡 Tip

  Путь с API-ключом Установите GOOGLE_API_KEY или GEMINI_API_KEY. Гермес впоследствии оба назывался провайдером «Близнецы».

Быстрый старт

# Добавьте ваш API-ключ Gemini
echo "GOOGLE_API_KEY=..." >> ~/.hermes/.env

# Выберите Gemini в качестве провайдера
hermes model
# → Выберите "More providers..." → "Google AI Studio"
# → Hermes проверит ваш тарифный план и покажет модели Gemini
# → Выберите модель

# Начните чат
hermes chat

Если вы предпочитаете прямое редактирование конфигурации, используйте небольшой базовый URL-адрес Gemini API:

model:
  default: gemini-3-flash-preview
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

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

После выполнения hermes model ваш ~/.hermes/config.yaml будет сохраняться:

model:
  default: gemini-3-flash-preview
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

А в ~/.hermes/.env:

GOOGLE_API_KEY=...

Нативный API Gemini

Рекомендуемая конечная точка:

https://generativelanguage.googleapis.com/v1beta

Гермес обнаруживает эту конечную точку и создает свой собственный адаптер Близнецов. Внутренний Hermes по-прежнему хранит цикл агента в сообщениях, ориентированных на OpenAI, а затем преобразует каждый запрос в собственную схему Gemini:

• messages[] → Gemini contents[]
• системные подсказки → Gemini systemInstruction
• схемы инструментов → Gemini functionDeclarations
• результаты инструментов → Детали Gemini functionResponse
• потоковые ответы → чанки потока в формате OpenAI для цикла Hermes

  📝 Note

  Сигнатуры мыслей Gemini 3 Для использования инструментов Gemini 3 Hermes сохраняйте значения « ThoughtSignature », прикрепляйте к частям функции функции и воспроизводите их на следующем этапе инструмента. Это закрывает путь для проверки агентом многих рабочих процессов.

Близнецы 3 также могут прикрепить сигнатуры мыслей к другим частям ответа. Нативный адаптер Hermes сегодня используется для циклов инструментов агента, поэтому он пока не воспроизводит каждую сигнатуру, не связанную с вызовом инструмента, с полной глубиной на уровне частей.