Hermes Agent через kosareva.cloud
Hermes — открытый агент от Nous Research, который живёт не в редакторе, а на вашем сервере: дешёвый VPS, домашняя машина, что угодно с постоянным подключением. Общаться с ним можно из Telegram, Discord или Slack, он помнит прошлые разговоры, заводит себе навыки и выполняет задачи по расписанию, пока вы спите.
Своего облака у него нет: запросы идут прямо на тот адрес, который вы указали в конфиге. Поэтому он работает из России без VPN, а платить за токены можно в рублях по факту — агенту, который крутится круглосуточно, это подходит лучше подписки.
Как подключить
/1Получите ключ и поставьте ему лимит
Создайте API-ключ в личном кабинете и пополните баланс — от 50 ₽.
Заведите агенту отдельный ключ и лимит в рублях — это поле есть прямо в окне создания ключа. Агент работает сам: расписания и фоновые задачи тратят токены без вашего участия, и лимит превращает неудачную ночь в ограниченный убыток, а не в пустой баланс.
/2Установите Hermes
На Linux, macOS, WSL2 или Android:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashДля Windows у проекта есть отдельный установщик и вариант с PowerShell — смотрите документацию Hermes. Ставить нашу сторону ничего не нужно, агент общается с нами по обычному HTTPS.
/3Пропишите нас в config.yaml
Откройте ~/.hermes/config.yaml (на Windows — %LOCALAPPDATA%\hermes\config.yaml) и задайте секцию model:
model:
default: claude-sonnet-5
provider: custom
base_url: https://api.kosareva.cloud/v1
api_key: ВАШ_API_КЛЮЧ
Адрес именно с /v1 на конце: формат OpenAI-совместимый, тот же, что у остальных инструментов. То же самое настраивает мастер: команда hermes model, пункт Custom endpoint.
Если в конфиге уже есть старый список custom_providers, переписывать его не обязательно: Hermes читает и его, а hermes update сам переносит его в новый формат.
/4Выберите модель
Имя модели в default — любое из каталога с окном от 64 000 токенов: Hermes узнаёт размер окна у нашего /v1/models и модели с меньшим окном не запускает. Для агентских задач обычно берут claude-sonnet-5, для фоновых рутин подешевле — deepseek-v4-flash.
Сменить модель потом можно той же командой hermes model. Команда /model в переписке меняет модель только для текущей сессии.
/5Перезапустите и проверьте
После правки конфига перезапустите агента и задайте ему любой вопрос. Если ответ пришёл — всё на месте; расход появится в разделе «Статистика» кабинета, по этому ключу отдельно.
Что учесть
- Если в переписке вы уже переключали модель командой агента, этот выбор переживает перезапуск и правка конфига на такую сессию не подействует. Начните новую или снимите переопределение.
- Память и навыки растут, и вместе с ними растёт контекст каждого запроса. Это главный источник расхода у долгоживущего агента — смотрите статистику по ключу первые дни.
- Всё, что вы напишете агенту, попадёт в его журналы на диске и уйдёт в модель. Пароли, ключи и доступы ему не отправляйте — ни в чате, ни в задачах.
- Нулевой баланс блокирует запросы, и агент замолкает молча. Настройте уведомление о низком балансе в кабинете.
Список моделей
Hermes подключает нас как свой OpenAI-совместимый эндпоинт. Размер окна модели он узнаёт у нашего /v1/models и требует не меньше 64 000 токенов.
- Протокол
- OpenAI-совместимый, Chat Completions
- Адрес
https://api.kosareva.cloud/v1- Имя модели
- как в каталоге, латиницей через дефисы:
claude-sonnet-5-5 - Подходят
- Текстовые модели каталога с окном от 64 000 токенов — сейчас их 102. Не подойдут YandexGPT 5.1 Pro, YandexGPT 5 Pro и YandexGPT 5 Lite — у них окно 32 768 токенов.
| Модель | Имя в запросе | Контекст, токенов | Вход / выход за 1M |
|---|---|---|---|
| Claude Sonnet 5.5 | claude-sonnet-5-5 | 1 000 000 | 216 / 1 080 ₽ |
| Claude Opus 5.5 | claude-opus-5-5 | 1 000 000 | 432 / 2 160 ₽ |
| GPT-6.1 Sol | gpt-6-1-sol | 1 050 000 | 216 / 1 080 ₽ |
| Gemini 3.8 Flash | gemini-3-8-flash | 1 048 576 | 81 / 405 ₽ |
| Kimi K2.7 Code | kimi-k2-7-code | 262 144 | 103 / 432 ₽ |
| GLM-5.3 | glm-5-3 | 1 310 720 | 151 / 475 ₽ |
| Qwen3.8 Max | qwen3-8-max | 1 000 000 | 216 / 648 ₽ |
| DeepSeek V4.1 Flash | deepseek-v4-1-flash | 1 048 576 | 32,4 / 130 ₽ |
Все модели с ценами — на странице цен. Точные имена отдаёт и сам API по адресу /v1/models.
Какие функции Hermes работают через kosareva.cloud
Hermes живёт на вашем сервере и к нам ходит только за ответами модели. Почти всё работает со своим ключом.
Telegram, Discord и Slack работает
Шлюз мессенджеров настраивается командой hermes gateway setup, модель берётся из того же config.yaml.
Память и навыки работает
Хранятся у вас на диске, работают с любой моделью из каталога.
Задачи по расписанию работает
Выполняются, пока запущен шлюз Hermes.
Субагенты работает
Наследуют провайдера основной модели — тоже идут через наш ключ.
Вспомогательные задачи с оговорками
Заголовки, работа с картинками, сжатие истории по умолчанию идут на основную модель. Если она чего-то не умеет — например, не принимает картинки, — Hermes пропускает такую задачу с предупреждением.
Веб-поиск и браузер с оговорками
Работают через отдельные бэкенды Hermes, не через нас: часть бесплатна, часть со своим ключом.
Nous Tool Gateway не работает
Инструменты Nous Research по платной подписке Nous — к нашему ключу отношения не имеют.
Рекомендуемые модели для Hermes
Агент, который работает круглосуточно, тратит токены и без вас. Поэтому выбор модели для Hermes — это ещё и выбор месячного расхода.
Claude Sonnet 5.5 claude-sonnet-5-5
Основная для агентских задач: инструменты, длинные инструкции, многошаговая работа. Стоит столько же, сколько Sonnet 5 из примера выше.
GPT-6.1 Sol gpt-6-1-sol
Окно больше миллиона токенов: память и навыки растут, а запросы по-прежнему помещаются.
Gemini 3.8 Flash gemini-3-8-flash
Принимает на вход картинки и видео — пригодится, если агенту присылают скриншоты и фото из мессенджеров.
DeepSeek V4.1 Flash deepseek-v4-1-flash
Для задач по расписанию и простых ответов: в разы дешевле флагманов, окно на миллион токенов.
Устранение неполадок
Наши ошибки приходят с русским текстом — по нему и ищите свой случай. Подробные разборы — в справочнике.
Hermes не запускается: мало контекста
Hermes требует от модели окно не меньше 64 000 токенов и меньшие отклоняет при старте. Размер он узнаёт у нашего /v1/models. Из каталога не подойдут YandexGPT 5.1 Pro, YandexGPT 5 Pro и YandexGPT 5 Lite — у них окно 32 768 токенов — возьмите любую модель из таблицы выше.
401: «Ключ не найден» или «Ключ не принят»
Ключ скопирован не целиком, с пробелом или переносом строки, удалён в кабинете — или вставлен не в то поле. В Hermes ключ — api_key в секции model config.yaml или переменная в файле .env рядом с ним.
404: адрес без /v1 или с лишним хвостом
Базовый адрес — ровно https://api.kosareva.cloud/v1. Без /v1 запрос уходит мимо API, а с /chat/completions на конце путь удваивается — инструмент допишет его сам. В Hermes это base_url в секции model.
«Такой модели нет в каталоге»
Имя модели — как в каталоге: латиницей через дефисы, например claude-sonnet-5-5. Вариант через точку шлюз поймёт сам, а с префиксом вендора (anthropic/…), датой версии или пробелом — нет. В Hermes — default в секции model. Модель, выбранная командой /model в переписке, переживает перезапуск и перекрывает конфиг.
402: «Закончились средства на балансе»
На балансе не хватает денег на запрос. Пополните его в кабинете картой или СБП — от 50 ₽. Если деньги на балансе есть, а отказ повторяется, проверьте, не стоит ли у ключа свой лимит в рублях.
Ответ обрывается на полуслове
Модель упёрлась в потолок длины ответа — max_tokens. Поднимите его или попросите модель продолжить. Обратная ошибка — 400 «Запрос длиннее, чем помещается в контекст этой модели»: потолок ответа вместе с историей не влезает в окно модели. Тогда уменьшите потолок или сожмите историю.
Долго нет ответа или 504
Длинный ответ без потоковой выдачи идёт минутами, и инструмент может сдаться раньше модели. Таймаут запроса в Hermes задаётся параметром провайдера request_timeout_seconds. Если пришёл наш 504 «Модель не ответила за отведённое время», деньги за такой запрос не списываются — повторите его.
Частые вопросы
Нужен ли VPS?
Hermes работает на любой машине с постоянным подключением: недорогой VPS, домашний сервер. Если возиться с сервером не хочется, мы держим Hermes у себя — см. Hermes под ключ.
Нужен ли VPN?
Нет. Hermes обращается к нашему API напрямую, он отвечает из России. Мессенджеры подключаются отдельно и от нас не зависят.
Сколько стоит агент в месяц?
Зависит от модели и того, сколько вы с ним говорите: платите только за токены, абонентской платы нет. Заведите агенту отдельный ключ с лимитом в рублях — расход будет виден по дням.
Можно ли сменить модель прямо из мессенджера?
Да: команда /model в переписке меняет модель для текущей сессии. Чтобы сменить её насовсем, используйте hermes model или правку config.yaml.
Работает ли Hermes на Windows?
Да, без WSL и Docker: для PowerShell у проекта есть свой установщик, он описан в документации Hermes. Настройки и config.yaml лежат в %LOCALAPPDATA%\hermes\.
Рекомендуемые модели и цены
На странице модели — все цены, включая кэш, и калькулятор расхода.
Claude Sonnet 5.5
Новый Sonnet: прямая замена Sonnet 5 по той же цене
GPT-6.1 Sol
Обновление GPT-6 Sol: та же цена, чтение кэша вдвое дешевле, контекст свыше 1M, картинки и файлы
Gemini 3.8 Flash
Самая сильная модель линейки Flash: код, агенты и многошаговые рассуждения
DeepSeek V4.1 Flash
Новая Flash с рассуждениями и картинками