ДокументацияHermes Agent

Hermes Agent

Hermes Agent подключается к Zenvy как к OpenAI-compatible провайдеру: достаточно задать Base URL и ключ через переменные окружения — и агент будет работать через ваш баланс Zenvy.

Что понадобится

API-ключ Zenvy вида sk-zenvy-... из раздела API-ключи.
Положительный баланс аккаунта.
Установленный Hermes Agent.

Важно

Вставляйте именно Zenvy-ключ sk-zenvy-..., а не ключ OpenAI или Anthropic.

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

Шаг 1. Установите Hermes Agent

~/zenvy · macOS / Linux / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

После установки перезагрузите shell:

~/zenvy · macOS / Linux

source ~/.bashrc   # или source ~/.zshrc

Проверьте установку:

~/zenvy · zsh

hermes --version

Шаг 2. Задайте переменные окружения

Укажите базовый адрес Zenvy и ваш API-ключ:

~/zenvy · macOS / Linux

export OPENAI_BASE_URL="https://api.zenvy.su/v1"
export OPENAI_API_KEY="sk-zenvy-..."

Шаг 3. Запустите Hermes Agent

~/zenvy · zsh

hermes

Постоянная настройка

Чтобы не задавать переменные заново в каждом терминале:

~/zenvy · macOS / Linux

echo 'export OPENAI_BASE_URL="https://api.zenvy.su/v1"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="sk-zenvy-..."' >> ~/.bashrc
source ~/.bashrc

После сохранения откройте новый терминал.

Выбор модели

Для агентных задач нужна модель с поддержкой tool calling:

Модель	Когда выбирать
`claude-sonnet-4.6`	Сложные многошаговые задачи
`gpt-5.2`	Крупные рефакторинги и анализ
`deepseek-chat`	Дешёвые вспомогательные задачи

Что поддерживает Zenvy для агентов: tools, tool_choice, parallel_tool_calls, response_format, streaming — через POST /v1/chat/completions. Подробнее: Вызов инструментов.

Проверка подключения

Перед запуском агента проверьте ключ напрямую:

~/zenvy · zsh

curl https://api.zenvy.su/v1/chat/completions \
  -H "Authorization: Bearer sk-zenvy-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [{ "role": "user", "content": "Ответь одним словом: ok" }]
  }'

Устранение неполадок

Симптом	В чём проблема
`401 authentication_error`	В `OPENAI_API_KEY` указан неверный ключ. Нужен ключ Zenvy `sk-zenvy-...`, не OpenAI.
`402 billing_error`	На балансе Zenvy нет средств. Пополните баланс в личном кабинете.
`404 model_not_found`	Выбрана модель, которой нет в Zenvy. Проверьте ID через `GET /v1/models`.
Агент игнорирует Base URL	Переменные заданы в другом терминале или не сохранены. После постоянной настройки откройте новый терминал.
Модель не вызывает инструменты	Выбрана модель без tool calling. Возьмите модель с `tools: true` в каталоге.

Безопасность

Не коммитьте конфиг с ключом в git.
Если ключ утёк, удалите его в кабинете Zenvy и создайте новый.