Hermes Agent 2026 — установка за 60 секунд на Mac, Linux и VPS

<div
  style="background:#141414; border:2px solid #FFC176; border-radius:20px; padding:30px; font-family:sans-serif; color:#F5F5F0; max-width:600px; box-shadow:0 0 30px rgba(255,193,118,0.15);"
>
  <h3 style="color:#FFC176; text-transform:uppercase; margin-top:0;">
    CHECKLIST: ПОДГОТОВКА 2026
  </h3>
  <ul style="list-style:none; padding:0;">
    <li style="margin-bottom:15px; display:flex; align-items:center;">
      <span
        style="background:#FFC176; color:#141414; border-radius:50%; width:24px; height:24px; display:inline-flex; items-center:center; justify-content:center; margin-right:12px; font-weight:bold;"
        >1</span
      >
      API Ключи (OpenRouter / Google)
    </li>
    <li style="margin-bottom:15px; display:flex; align-items:center;">
      <span
        style="background:#FFC176; color:#141414; border-radius:50%; width:24px; height:24px; display:inline-flex; items-center:center; justify-content:center; margin-right:12px; font-weight:bold;"
        >2</span
      >
      Railway Account & Credits
    </li>
    <li style="margin-bottom:15px; display:flex; align-items:center;">
      <span
        style="background:#FFC176; color:#141414; border-radius:50%; width:24px; height:24px; display:inline-flex; items-center:center; justify-content:center; margin-right:12px; font-weight:bold;"
        >3</span
      >
      Docker & GitHub Repo (Elisaffetta-fork)
    </li>
    <li style="display:flex; align-items:center;">
      <span
        style="background:#FFC176; color:#141414; border-radius:50%; width:24px; height:24px; display:inline-flex; items-center:center; justify-content:center; margin-right:12px; font-weight:bold;"
        >4</span
      >
      Telegram Bot Token (@BotFather)
    </li>
  </ul>
</div>

Установка Hermes Agent на Mac или Linux — это одна команда curl в терминале. Python, Node.js и все зависимости ставятся автоматически. После этого запускаете hermes setup, выбираете провайдера (бесплатный OpenRouter или Nous Portal), и агент готов к работе. Для работы 24/7 без привязки к компьютеру — ставьте на VPS: Railway или Timeweb Cloud от 882 ₽ в месяц.

В этом гайде — полная инструкция для трех сценариев: локальная установка на Mac, установка на Linux-сервер и деплой на VPS с пошаговым разбором интерфейса.

Что такое Hermes Agent и почему о нем сейчас все говорят

Hermes Agent — open-source AI-агент от Nous Research. 146 000 звезд на GitHub за несколько месяцев, активное сообщество и релиз v0.13.0 от 7 мая 2026 года.

Но дело не в звездах. Дело в одном принципиальном отличии от ChatGPT, Claude, да и даже того же самого OpenClaw, про которого ну оочень много говорили.

Обычный AI-чат stateless: каждый раз начинает с нуля, не помнит что вы делали вчера, не учится на ваших задачах. Hermes stateful: каждая сессия питает следующую. Он записывает как вы работаете, превращает удачные решения в навыки и через месяц работает заметно лучше, чем в первый день. Те, кто переходил с OpenClaw, отмечают три вещи: Hermes быстрее, стабильнее, не деградирует при накоплении контекста.

Максим: «Мы в gobanana.ru тестировали разные агентные инструменты. Hermes взял тем, что реально учится — через неделю он уже понимал наш стек без длинных объяснений. 200 000 пользователей на продукте, и инструмент который экономит по 3-4 часа в неделю — это не мелочь»

Выбираем где запускать — локально или на сервере

Перед установкой важно определиться: зачем вам Hermes и как вы планируете им пользоваться.

По опыту тех, кто плотно работает с Hermes: большинство начинают локально, а через 1-2 дня переносят на VPS. Потому что агент, который выключается вместе с вашим компьютером, теряет половину своей ценности.

Часть 1. Установка на Mac и Linux — самый быстрый способ

Что нужно перед стартом

Единственное обязательное требование — Git. Всё остальное (Python 3.11, Node.js v22, uv, ripgrep, ffmpeg) установщик подтянет сам.

Проверяем Git:

git --version

Если пишет command not found:

# На Ubuntu/Debian:
sudo apt install git

# На macOS (запустит установку Xcode Command Line Tools):
xcode-select --install

Также понадобится около 1.5 GB свободного места и доступ в интернет — GitHub и выбранный LLM-провайдер должны быть доступны.

Шаг 1. Одна команда — и установка пошла

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Это официальная команда из документации Nous Research. Запускаете её в терминале и ждёте 1-3 минуты. В это время:

• Устанавливается uv (менеджер Python-пакетов, написан на Rust — в 10-100 раз быстрее pip)
• Через uv ставится Python 3.11
• Устанавливается Node.js v22
• Клонируется репозиторий Hermes в ~/.hermes/hermes-agent/
• Создаётся симлинк hermes в ~/.local/bin/

Когда видите строку ✅ Hermes Agent installed at ~/.hermes — готово.

На свежем Mac — нюанс. macOS 12+ не поставляется с Homebrew. Если установщик споткнулся — сначала установите Homebrew: зайдите на brew.sh и скопируйте команду с главной страницы в терминал. После этого повторяйте установку Hermes.

Шаг 2. Обязательный — перезагружаем shell

После установки нужно перезагрузить оболочку, чтобы она увидела новую команду hermes:

source ~/.bashrc    # bash (большинство Linux)

source ~/.zshrc     # zsh (стандарт на macOS)

Или просто закройте терминал и откройте новый. Проверяем:

hermes --version

Видите версию — отлично. Видите command not found — откройте именно новое окно терминала, это надёжнее чем source.

Часть 2. Настройка — выбираем провайдера

Запускаем мастер настройки

hermes setup

Или если хотите только выбрать модель и провайдера:

hermes model

Мастер проведёт вас через всё интерактивно. Главный вопрос — какого провайдера выбрать.

Какого провайдера выбрать новичку

Hermes бесплатный (MIT-лицензия). Вы платите только за API модели, которую используете.

Важная деталь про локальные модели. Частая ошибка первых дней — ставить маленькую локальную модель (Gemma 2B, Llama 8B) для агентских задач. Маленькие модели не умеют надёжно вызывать инструменты, застревают в циклах и не справляются с многошаговыми задачами. Hermes требует минимум 64 000 токенов контекста. Gemma 2B на это не тянет. Для офлайн-режима работает Qwen 3.5 27B или Gemma 4 E4B (9.6 GB) — но это уже другой разговор.

Для старта без лишних хлопот: OpenRouter с бесплатными моделями (ищите тег «free» в каталоге) или Nous Portal, если хотите фиксированную стоимость и доступ ко всем провайдерам через одну авторизацию.

После выбора провайдера — первый запуск

hermes

Откроется интерактивный терминал. Напишите что-нибудь простое:

> Найди все .txt файлы в текущей директории

Агент вызовет инструмент поиска и вернёт результат. Работает — установка прошла успешно.

Часть 3. Установка на VPS для работы 24/7

Это самый правильный способ использовать Hermes по мнению тех, кто с ним работает давно. Агент на VPS не зависит от вашего компьютера, работает круглосуточно, принимает сообщения через Telegram пока вы спите.

Есть два пути: Railway (удобнее, автодеплой из GitHub) или Timeweb Cloud (дешевле, оплата рублями, больше контроля).

Вариант А. Railway — быстрый старт за $5/мес

Railway — облачная платформа с удобным интерфейсом. Не нужно знать Linux, не нужен SSH. Всё через браузер.

Что нужно до начала:

• Аккаунт на GitHub
• Аккаунт на Railway (регистрация через GitHub — самый удобный вариант)
• Иностранная карта для оплаты (армянская, казахстанская, Revolut)

Шаг 1. Форкаем репозиторий Hermes к себе на GitHub

Форк — это копия чужого репозитория в вашем аккаунте. Нужно чтобы Railway мог читать код и деплоить его.

Открываете github.com/NousResearch/hermes-agent. В правом верхнем углу нажимаете кнопку "Fork", затем "Create fork". Через несколько секунд в вашем GitHub-аккаунте появится ваш-логин/hermes-agent.

Шаг 2. Фиксим Dockerfile под Railway

Hermes поставляется со своим Dockerfile, но в нём есть команда VOLUME на строке 112 — Railway её не поддерживает и сборка падает с ошибкой:

dockerfile invalid: docker VOLUME at Line 112 is not supported, use Railway Volumes

Нужно закомментировать эту строку. Делается прямо в интерфейсе GitHub — не нужен редактор кода.

Идёте в свой форк: github.com/ваш-логин/hermes-agent. Находите файл Dockerfile в корне репозитория, кликаете на него. В правом верхнем углу файла нажимаете иконку карандаша (Edit). Находите строку 112 — там будет что-то вроде VOLUME [...]. Добавляете # в начало строки — это её закомментирует:

# VOLUME ["/root/.hermes"]

Внизу нажимаете зелёную кнопку "Commit changes", затем ещё раз "Commit changes" в появившемся окне.

Шаг 3. Создаём проект в Railway

Заходите на railway.app. Нажимаете "+ New Project" в правом верхнем углу. В появившемся меню выбираете "GitHub Repository".

Railway попросит доступ к GitHub — даёте разрешение. Видите список репозиториев. Находите hermes-agent (тот что вы форкнули) и кликаете на него.

Railway автоматически обнаружит Dockerfile и начнёт сборку. В интерфейсе появится карточка сервиса со статусом BUILDING. Сборка занимает 2-5 минут.

Шаг 4. Проверяем что сборка прошла успешно

Кликаете на карточку сервиса hermes-agent. Открывается панель с вкладками: Deployments, Variables, Metrics, Settings.

На вкладке Deployments должен быть зелёный статус SUCCESS. Если красный FAILED — нажимаете "View logs" и смотрите последнюю строку с ошибкой.

Шаг 5. Прописываем переменные окружения

Это самый важный шаг — без него агент запустится, но не будет знать какую модель использовать и не подключится к Telegram.

Кликаете на сервис, переходите на вкладку Variables. Нажимаете "+ New Variable" и добавляете каждую переменную отдельно.

Минимальный набор для работы через Telegram с OpenRouter:

Если используете Nous Portal:

Как получить каждый ключ:

Токен Telegram-бота: открываете Telegram, находите @BotFather, пишете /newbot. Придумываете имя — оно должно заканчиваться на bot (например MyHermesBot). BotFather отдаёт токен вида 7123456789:AAF... — вот это и вставляете.

Ваш Telegram ID: пишете боту @userinfobot — он ответит числом вида 123456789. Это и есть ваш ID.

Ключ OpenRouter: регистрируетесь на openrouter.ai, идёте в раздел Keys, нажимаете "Create Key". Бесплатные модели есть — ищите в каталоге тег «free».

После добавления всех переменных Railway автоматически перезапустит сервис с новыми настройками.

Шаг 6. Проверяем что агент работает

Открываете Telegram, находите своего бота по имени которое дали в BotFather, пишете /start. Если агент отвечает — всё готово.

Если бот молчит — идёте в Railway, вкладка Deployments, нажимаете "View logs" на последнем деплое. Там будет видно что именно пошло не так.

Частая проблема: добавили переменные, но деплой не перезапустился автоматически. В этом случае идёте на вкладку Deployments и нажимаете "Redeploy" на последнем успешном деплое.

Цены Railway

• Trial — $5 стартовых кредитов при регистрации, хватает на 2-3 недели тестирования
• Hobby — $5/месяц, 8 GB RAM, 8 vCPU, этого с головой хватает для Hermes
• Pro — $20/месяц, больше ресурсов и командный доступ

Оплата только иностранной картой. Если нужна оплата рублями — смотрите Вариант Б с Timeweb Cloud.

Вариант Б. Timeweb Cloud — оплата рублями, полный контроль

Timeweb Cloud — российский провайдер. VPS от 882 ₽ в месяц, оплата рублевыми картами, СБП и ЮMoney. Для Hermes достаточно конфигурации с 4 GB RAM.

Шаг 1. Создание сервера

Заходите на timeweb.cloud. Раздел "Облачные серверы" -> "Создать сервер".

Выбираете:

• ОС: Ubuntu 22.04 LTS
• RAM: 4 GB (минимум для агента), 8 GB если планируете параллельные задачи
• SSD: 40 GB хватит
• Регион: Москва или Санкт-Петербург

После создания на почту придут IP-адрес, имя пользователя (обычно root) и пароль.

Шаг 2. Подключение по SSH

Открываете терминал на вашем компьютере:

ssh root@ваш_ip_адрес

Вводите пароль из письма. Если используете Termius (удобный SSH-клиент для Mac/Windows) — создаёте новый хост, вбиваете IP, логин и пароль. Подключились — видите командную строку сервера.

Шаг 3. Обновляем систему и ставим Hermes

На свежем Ubuntu сначала:

sudo apt update && sudo apt upgrade -y

Затем проверяем Git:

git --version

Если не установлен: sudo apt install git -y

Теперь устанавливаем Hermes — та же команда, что и локально:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Ждём 2-4 минуты. После завершения:

source ~/.bashrc
hermes --version

Шаг 4. Настройка агента на сервере

hermes setup

Проходите мастер настройки: выбираете провайдера, вводите API-ключ. Если используете MiniMax и сервер за пределами Китая — выбирайте "global direct API", не China endpoint.

Шаг 5. Запуск агента в фоне

Если просто запустить hermes gateway, агент остановится когда вы закроете SSH-сессию. Чтобы он работал постоянно — используем screen или systemd.

Простой способ через screen:

screen -S hermes
hermes gateway

Нажимаете Ctrl+A, затем D — выходите из screen, агент остаётся работать. Вернуться к нему: screen -r hermes.

Более надёжный способ — создать systemd-сервис:

sudo nano /etc/systemd/system/hermes.service

Вставляете:

[Unit]
Description=Hermes Agent
After=network.target

[Service]
User=root
ExecStart=/root/.local/bin/hermes gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Сохраняете (Ctrl+X, Y, Enter). Запускаете:

sudo systemctl enable hermes
sudo systemctl start hermes
sudo systemctl status hermes

Зелёный статус active (running) — агент работает и будет автоматически перезапускаться при сбоях.

Подключение Telegram — работаем с телефона

После установки на VPS большинство переходят на Telegram-интерфейс. Это удобнее: общаетесь с агентом из любой точки, можно отправлять голосовые сообщения, работать с телефона.

Создаём бота в Telegram:

1. Открываете Telegram, находите @BotFather
2. Отправляете /newbot
3. Придумываете имя бота (например MyHermesBot) — оно должно заканчиваться на bot
4. BotFather отдаёт токен вида 7123456789:AAF...

Узнаём свой Telegram ID:

Пишете боту @userinfobot — он ответит вашим User ID. Это число вида 123456789.

Подключаем к Hermes:

Запускаете hermes setup или hermes gateway, выбираете Telegram, вводите токен бота и свой User ID.

Обязательно укажите User ID в настройках — это ограничит доступ к агенту только для вас. Без этого бот будет отвечать любому кто напишет.

В v0.13.0 (релиз от 7 мая 2026) Gateway автоматически возобновляет прерванные сессии после перезапуска. Раньше при падении сервиса нужно было вручную восстанавливать контекст — теперь этого нет.

Полезные команды — шпаргалка

hermes              # запустить агента в терминале
hermes --continue   # продолжить последнюю сессию
hermes model        # сменить провайдера или модель
hermes setup        # полный мастер настройки
hermes doctor       # диагностика — проверяет 12 параметров
hermes gateway      # запустить мессенджер-шлюз (Telegram, Discord и др.)
hermes update       # обновиться до последней версии
hermes tools        # настроить доступные инструменты
hermes status       # текущий статус агента

Если агент не отвечает или ведёт себя странно — hermes doctor первым делом. Команда проверяет соединение с провайдером, версию Python, доступность инструментов и конфиг.

Частые ошибки и как их решить

hermes: command not found сразу после установки

Shell не подхватил новый PATH. Выполните source ~/.bashrc или откройте новое окно терминала. На macOS — source ~/.zshrc.

Установка зависает на Homebrew / Xcode

На свежем Mac нет инструментов разработчика. Отдельно выполните xcode-select --install, дождитесь завершения, затем снова запускайте curl-команду Hermes.

sudo apt update выдаёт ошибки на свежем VPS

На некоторых VPS нет Git и curl из коробки. Сначала: sudo apt update && sudo apt install git curl -y, потом устанавливайте Hermes.

API key not set при запуске

Провайдер не настроен. Запустите hermes model и пройдите настройку заново.

400 missing model при Nous Portal

Баг в версиях до v0.13.0: если список моделей не загрузился, мастер подставлял модели в неправильном формате. Обновитесь: hermes update.

Агент зависает в бесконечном цикле

Настройте max iterations (например, 60) через hermes setup. Это ограничит количество шагов агента на одну задачу и предотвратит бесконечные петли.

Windows: bad interpreter

Нативный Windows не поддерживается. Нужен WSL2. Открываете PowerShell от администратора, выполняете wsl --install, ждёте установки Ubuntu. После этого — запускаете установку Hermes внутри WSL как обычно.

Сравнение: локально против VPS

Глоссарий

Hermes Agent — open-source AI-агент от Nous Research. MIT-лицензия, бесплатный, требует внешнего LLM-провайдера.

stateful / stateless — stateless-агент начинает каждую сессию с нуля. Hermes stateful: сохраняет контекст, навыки и память между сессиями.

Skills (навыки) — MD-файлы с инструкциями, которые Hermes накапливает в работе. Каждый успешно решённый сценарий может превратиться в повторно используемый навык.

Gateway — мессенджер-шлюз Hermes. Позволяет общаться с агентом через Telegram, Discord, WhatsApp, Slack, Signal и другие платформы.

uv — быстрый менеджер пакетов Python, написан на Rust. Hermes использует его вместо pip.

OpenRouter — агрегатор API-провайдеров. Один ключ — доступ к 200+ моделям. Есть бесплатные модели.

Nous Portal — инференс-портал Nous Research. Подписка даёт доступ к Claude, GPT, GLM, MiniMax и моделям Nous через одну авторизацию.

VPS — виртуальный выделенный сервер. Ваш собственный Linux-сервер в облаке, доступный 24/7.

SSH — протокол безопасного подключения к удалённому серверу через терминал.

systemd — система управления сервисами в Linux. Позволяет автоматически запускать и перезапускать программы при старте сервера.

soul.md — системный промпт Hermes. Отредактировав этот файл, вы меняете базовое поведение агента: делаете его более автономным, меняете тон, добавляете персональный контекст.

FAQ

Hermes Agent бесплатный?
Сам агент MIT-лицензия и стоит ноль. Платите только за API модели. С OpenRouter и бесплатными моделями — тоже ноль. С Claude Sonnet 4.6 при интенсивной работе может выходить $20-50 в месяц. DeepSeek V3.2 за $0.28/1M токенов — бюджетная альтернатива frontier-уровня.

Можно ли установить Hermes Agent на Windows без WSL?
Нет. Нативный Windows не поддерживается. Нужен WSL2 — wsl --install в PowerShell, потом установка внутри Ubuntu.

Какой минимальный VPS нужен для работы агента?
4 GB RAM хватает для работы как персонального ассистента. 8 GB нужны если запускаете параллельные задачи или swarm из нескольких агентов. По стоимости: около $3-5 в месяц на западных VPS или от 882 ₽ в Timewef Cloud.

Как агент учится и накапливает навыки?
После каждых ~15 вызовов инструментов Hermes анализирует что сработало и записывает это как новый навык в ~/.hermes/skills/. Следующий раз на похожей задаче он уже знает как действовать. Через месяц использования это заметно.

Безопасно ли ставить Hermes на основной компьютер?
Агент получает доступ к файловой системе. Если планируете давать ему широкие права — ставьте на отдельный VPS или виртуальную машину. Для осторожной работы в терминале — локальная установка нормальна, но стоит ограничить доступные директории.

Как обновить Hermes до новой версии?
Одна команда: hermes update. Откат на предыдущую версию: hermes update --rollback.

Можно ли использовать Hermes с подпиской Claude Code от Anthropic?
Anthropic блокирует аккаунты за использование Claude-подписок в сторонних инструментах. Используйте API-ключ или Nous Portal для доступа к Claude-моделям.

Итог: что делаем прямо сейчас

Для старта локально (5 минут):

1. git --version — проверяем Git
2. Вставляем curl-команду, ждём 1-3 минуты
3. source ~/.bashrc или открываем новый терминал
4. hermes setup — выбираем OpenRouter с бесплатной моделью
5. hermes — пишем первое сообщение

Для VPS 24/7 (30 минут):

1. Регистрируемся на timeweb.cloud или railway.app
2. Создаём сервер Ubuntu 22.04, 4 GB RAM
3. Подключаемся по SSH, ставим Hermes командой curl
4. Создаём systemd-сервис для автозапуска
5. Подключаем Telegram через BotFather

Посмотрите каталог AI-инструментов VibeCoderz — там есть обзоры Windsurf, Cursor, Claude Code и других инструментов, которые работают в связке с агентами. Если нужна помощь с настройкой стека — запишитесь на консультацию к Максиму.

Обновлено: май 2026. Версия Hermes Agent — v0.13.0 (2026.5.7), актуальна на момент публикации.