Hermes - самообучающийся AI-агент от Nous Research. Он создаёт навыки из опыта, помнит прошлые диалоги, умеет работать по расписанию и отвечать в Telegram, Discord, Slack и других мессенджерах. При этом агент не привязан к одному провайдеру моделей: Hermes понимает любой OpenAI-совместимый API, а значит, легко подключается и к моделям AI Studio.
Ещё одна приятная черта: Hermes рассчитан на то, чтобы жить не в вашем ноутбуке, а на сервере - хоть на небольшой VDS. Запустили агента один раз, а общаетесь с ним из мессенджера.
Как получить API-ключ
Этот ключ вы будете использовать для подключения Hermes к AI Studio.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
После установки перечитайте конфигурацию оболочки и запустите агента:
source ~/.bashrc # или source ~/.zshrc
hermes
Hermes полностью работает в нативной Windows без WSL. Выполните в PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Установка попадёт в каталог %LOCALAPPDATA%\hermes. Если предпочитаете WSL2 - используйте скрипт из соседней вкладки.
Hermes подключается к любому OpenAI-совместимому эндпоинту через провайдер custom. Для AI Studio это значит указать базовый URL https://ai.netangels.cloud/v1 и ваш API-ключ. Есть два способа: удобный мастер или правка конфига вручную.
hermes model
В списке провайдеров выберите Custom endpoint и ответьте на вопросы мастера:
базовый URL: https://ai.netangels.cloud/v1
API-ключ из личного кабинета AI Studio
модель по умолчанию, например qwen-plus
Мастер сам сохранит настройки в ~/.hermes/config.yaml, включая режим протокола (chat_completions). Это рекомендуемый путь - ошибиться в формате конфига невозможно.
Откройте конфигурационный файл:
nano ~/.hermes/config.yaml
Найдите блок model: и приведите его к виду:
model:
provider: "custom"
base_url: "https://ai.netangels.cloud/v1"
default: "qwen-plus"
api_key: "ВАШ_API_КЛЮЧ"
Замените ВАШ_API_КЛЮЧ на реальный ключ из личного кабинета. Если не хотите хранить ключ в конфиге, Hermes умеет брать его из файла секретов ~/.hermes/.env.
Не заменяйте файл целиком
В config.yaml хранятся и другие настройки агента - редактируйте только блок model:, иначе потеряете остальные параметры. Если после правки что-то пошло не так, диагностика сама подскажет: hermes doctor.
Запустите Hermes:
hermes
Отправьте агенту тестовое сообщение - если модель ответила, всё настроено верно. Текущие настройки провайдера можно посмотреть командами:
hermes config get model.provider
hermes config get model.base_url
А полную диагностику окружения и подключения выполняет hermes doctor.
Модель меняется на лету командой /model прямо из диалога:
/model qwen-max
Список доступных моделей с ценами всегда виден в личном кабинете, в разделе AI Studio. Если нужно сменить и модель, и провайдера целиком - снова запустите hermes model.
Вспомогательные задачи
У Hermes есть фоновые задачи - сжатие истории, генерация названий, анализ изображений. По умолчанию они идут на ту же модель, что и основной диалог, поэтому отдельно для AI Studio настраивать ничего не нужно.
Самый частый сценарий использования: агент крутится на сервере, а вы общаетесь с ним через Telegram. Для этого запустите шлюз сообщений:
hermes gateway setup # настроить каналы (Telegram, Discord, Slack, ...)
hermes gateway start
После привязки канала боту можно писать как обычному собеседнику - со всеми навыками, памятью и планировщиком задач. Подробности - в документации шлюза Hermes.
Ошибка авторизации (401/403). Убедитесь, что ключ взят из раздела AI Studio личного кабинета и скопирован без лишних пробелов. Быстрый тест ключа - запрос к API через cURL.
Модель не отвечает. Проверьте базовый URL: он должен заканчиваться ровно на /v1, без пути /chat/completions - его Hermes добавляет сам. После любой правки конфига перезапустите агента.
Неверный размер контекста. Hermes определяет окно контекста модели автоматически через эндпоинт /v1/models. Если автоопределение не сработало, задайте значение вручную параметром context_length в блоке model: (например, context_length: 131072).
| Команда | Описание |
|---|---|
hermes |
Запустить интерактивный терминал агента |
hermes model |
Выбрать провайдера и модель |
hermes tools |
Настроить, какие инструменты включены |
hermes gateway |
Шлюз мессенджеров (setup / start) |
hermes doctor |
Диагностика проблем |
/new |
Начать новый диалог |
/model <имя> |
Переключить модель |
/compress |
Сжать историю диалога |
/usage |
Расход токенов |
Протокол, по которому Hermes общается с AI Studio, подробно описан в статье OpenAI Chat Completions API через AI Studio - там же примеры запросов на Python, Node.js и cURL.
Полная документация Hermes: hermes-agent.nousresearch.com/docs.