Незрячий разработчик про ИИ и доступность

Hermes Agent: с чего начать — установка, настройка и полезные навыки

Незрячий разработчик про ИИ и доступность·7 Aug at 7:41 pm

Hermes Agent — это не просто ещё один чат с ИИ. Проще думать о нём так: это личный ИИ-помощник, которого можно поселить на компьютере или сервере и обращаться к нему из терминала, Telegram или другого мессенджера.

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

Если совсем просто: модель — это мозг, Hermes — это помощник с руками, памятью и рабочим местом, а Telegram может быть удобной дверью, через которую вы к нему обращаетесь.

Эта статья — практический стартовый мануал. Сначала разберём базовую установку, потом вариант с VPS на Beget: как арендовать сервер, подключиться по SSH, поставить Hermes, подключить модель и проверить первый запуск. Терминал понадобится на этапе установки и настройки, но дальше основная работа может идти через обычный Telegram-бот.

Кому это может пригодиться

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

Главная польза Hermes — он превращает ИИ из собеседника в помощника, который может делать повторяющиеся рабочие действия.

Важное про безопасность

Никогда не публикуйте реальные API-ключи, токены ботов, приватные ключи кошельков и содержимое файлов .env, auth.json, config.yaml, если там есть секреты.

Не отправляйте никому IP сервера, пароль от VPS, приватный SSH-ключ и одноразовые коды авторизации. В статье ниже используются условные значения вроде SERVER_IP и учебные примеры. У вас вместо них будут свои данные.

Секреты храните локально:

~/.hermes/.env        # API-ключи и токены
~/.hermes/config.yaml # настройки Hermes
~/.hermes/auth.json   # OAuth/авторизация, не публиковать

1. Где запускать Hermes: локально или на VPS

Если вы просто хотите попробовать Hermes в терминале, можно начать локально: Linux, macOS, WSL2, Termux или Windows PowerShell.

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

В примере беру Beget, потому что панель у него достаточно понятная для новичка. Ссылка на VPS: https://beget.com/p1158899/vps

Для совсем простого опыта в терминале может хватить 2 GB RAM. Но если вы хотите использовать Hermes как нормального агента — с браузером, файлами, поиском и инструментами — лучше сразу взять 4 GB RAM. Запас небольшой, но он сильно снижает шанс, что всё начнёт тормозить на первом же практическом шаге.

Для этой инструкции я бы выбрал такой вариант:

OS: Ubuntu 24.04 LTS.
Region: Germany или Netherlands. Обычно это нормальный выбор для пользователя из России/Европы: близко, понятно, без экзотики.
CPU: 2 cores.
RAM: 4 GB.
Disk: 40 GB NVMe.
IPv4: включить.
Оплата: для теста можно выбрать посуточную оплату, если панель даёт такой вариант.

По цене в моём примере получилось около 38 ₽ в день: 33 ₽ за VPS и 5 ₽ за IPv4. За неделю это примерно 266 ₽. За месяц — около 1140–1180 ₽.

Выбор тарифа VPS на Beget: 2 CPU, 4 GB RAM, 40 GB NVMe

В панели Beget откройте раздел Cloud / VPS и создайте новый сервер. После создания сервер появится в списке VPS.

Созданный VPS в панели Beget. Личные данные и IP скрыты

2. Установка Hermes

Linux, macOS, WSL2 или Termux

Если ставите Hermes локально или уже подключились к серверу, базовая команда такая:

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

Подключение к VPS по SSH

В панели Beget будет IP сервера. Я не показываю свой IP в статье, поэтому дальше пишу SERVER_IP. У вас вместо этого будет ваш адрес.

Подключение выглядит так:

ssh root@SERVER_IP

Если используете SSH-ключ:

ssh -i ~/.ssh/your_key root@SERVER_IP

При первом входе терминал спросит, доверять ли серверу. Проверьте, что IP ваш, и ответьте yes.

Подключаемся к VPS по SSH: пример первого входа

На новом сервере сначала обновим пакеты:

apt update && apt upgrade -y

Поставим базовые утилиты:

apt install -y curl git python3 python3-venv python3-pip nodejs npm

Обновляем систему и ставим базовые утилиты

Теперь запускаем установку Hermes:

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

Запускаем установочный скрипт Hermes Agent

После установки перезапустите shell или выполните команду, которую покажет инсталлятор, чтобы hermes появился в PATH.

Проверка:

hermes --version
hermes doctor

Если команда показывает версию, установка прошла нормально.

Если hermes не найден:

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

Windows Native PowerShell — early beta

Нативная установка на Windows уже есть, но она помечена как early beta. Самый проверенный путь для Windows пока остаётся WSL2, но если хочется попробовать без WSL2, откройте PowerShell и выполните:

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

Что делает Windows-инсталлятор:

ставит Hermes в %LOCALAPPDATA%\hermes;
подтягивает uv, Python 3.11, Node.js, ripgrep, ffmpeg;
при необходимости ставит portable Git Bash через MinGit;
не требует прав администратора.

Ограничение на момент написания: классический CLI и gateway работают нативно, но браузерную панель чата в dashboard лучше использовать через WSL2, потому что ему нужен POSIX PTY.

3. Первичная настройка

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

hermes setup

Минимальный набор после установки:

hermes model   # выбрать провайдера и модель
hermes tools   # включить нужные инструменты
hermes doctor  # проверить проблемы

Для одиночного запроса без интерактивного режима:

hermes chat -q "Объясни, что такое Hermes Agent простыми словами"

Для обычной работы:

hermes

4. Подключение модели

Hermes поддерживает разные провайдеры: OpenAI Codex, Nous Portal, OpenRouter, Gemini, DeepSeek, локальные модели и другие варианты. Для новичка лучше не начинать со всех сразу, а выбрать один понятный путь.

Самый простой вариант, если у вас есть доступ к ChatGPT/Codex, — подключить OpenAI Codex через авторизацию без браузера на сервере.

Сначала проверьте, что в аккаунте ChatGPT включена авторизация устройств для Codex. В интерфейсе это может называться немного по-разному: Settings, Security, Data controls или Device code authorization for Codex. Если аккаунт рабочий, настройка может быть у администратора workspace.

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

hermes auth add openai-codex --type oauth --no-browser

Подключаем OpenAI Codex через авторизацию без браузера на сервере

На картинке выше ссылка и код условные. У вас Hermes покажет свои данные для одноразового входа.

Логика такая:

Открываете ссылку в браузере.
Входите в нужный аккаунт ChatGPT.
Вводите одноразовый код.
Возвращаетесь в терминал.
Hermes сохраняет доступ в своём auth-хранилище.

Потом запускаете выбор модели:

hermes model

В списке выберите OpenAI Codex / ChatGPT и модель для старта.

Для первой проверки можно взять быструю модель, например gpt-5.4-mini, если она доступна в вашем аккаунте. Для более сложных задач потом можно переключиться на более сильную модель из списка.

Если используете API-ключ другого провайдера, не вставляйте его в публичные команды. Добавьте его в локальный .env:

hermes config env-path
nano ~/.hermes/.env

Пример содержимого .env с плейсхолдером:

OPENROUTER_API_KEY=<ваш_ключ>
GOOGLE_API_KEY=<ваш_ключ>

После изменения ключей перезапустите Hermes или gateway.

Проверка:

hermes chat

И отправьте простой запрос:

Привет. Коротко объясни, что ты умеешь делать в Hermes Agent.

Если Hermes отвечает — базовая настройка готова.

Если авторизация через ChatGPT не сработала, проверьте:

включена ли device code authorization for Codex;
есть ли у аккаунта доступ к Codex-моделям;
не вошли ли вы не в тот Google/ChatGPT-аккаунт;
не блокирует ли сервер или сеть подключение к OpenAI.

Если всё равно не работает, можно настроить Hermes через другой провайдер в hermes model.

5. Полезные команды Hermes CLI

hermes                 # интерактивный чат
hermes chat -q "..."   # один запрос
hermes setup           # мастер настройки
hermes model           # выбор модели/провайдера
hermes tools           # включение и отключение инструментов
hermes tools list      # список toolsets
hermes doctor          # диагностика
hermes status --all    # статус компонентов
hermes config          # показать конфиг
hermes config edit     # открыть config.yaml
hermes config path     # путь к config.yaml
hermes config env-path # путь к .env
hermes update          # обновить Hermes

Внутри чата полезны slash-команды:

/new или /reset     начать новую сессию
/model              сменить модель
/tools              инструменты
/usage              расход контекста
/compress           сжать контекст
/stop               остановить фоновые процессы
/help               справка

6. Инструменты: что включать

Toolsets — это группы возможностей. Включаются через:

hermes tools

Часто полезны:

web — поиск и извлечение страниц;
browser — браузерная автоматизация;
terminal — выполнение команд;
file — чтение, запись и правка файлов;
vision — анализ изображений;
image_gen — генерация изображений;
tts — озвучка текста;
session_search — поиск по прошлым сессиям;
delegation — subagent-ы для параллельной работы;
cronjob — задачи по расписанию;
memory — долговременная память.

Важно: после изменения набора инструментов иногда нужен /reset, чтобы новая сессия получила обновлённый список toolsets.

7. Telegram и другие мессенджеры

Hermes можно использовать не только в терминале, но и через gateway.

Настройка:

hermes gateway setup

Запуск в foreground-режиме:

hermes gateway run

Установка как сервис:

hermes gateway install
hermes gateway start
hermes gateway status

Перезапуск после изменения настроек:

hermes gateway restart

Если gateway не отвечает, сначала смотрите логи:

hermes logs --follow
# или вручную
tail -n 100 ~/.hermes/logs/gateway.log

Для Telegram обычно понадобятся токен бота от BotFather и разрешение вашему аккаунту писать агенту. Токен бота храните только локально, не в статье и не в репозитории.

8. Skills: как Hermes становится удобнее

Skills — это процедурная память: инструкции, чеклисты и рабочие процессы, которые агент загружает под конкретную задачу.

Посмотреть навыки:

hermes skills list
hermes skills browse
hermes skills search accessibility

Установить skill из HermesHub, если он там есть:

hermes skills install <id_навыка>

9. Несколько публичных skills от web3blind

Ниже — публичные репозитории, которые можно поставить вручную. Это не полный каталог Hermes, а именно отдельные открытые навыки/воркфлоу.

coding-skill

Проектный рабочий процесс: уточнение задачи, план, реализация, проверка, отчёт.

tmpdir=$(mktemp -d)
git clone --depth 1 https://github.com/web3blind/coding-skill "$tmpdir/coding-skill"
mkdir -p ~/.hermes/skills/coding
cp -a "$tmpdir/coding-skill/." ~/.hermes/skills/coding/
rm -rf "$tmpdir"

getdocs-skill

Скачивание публичной документации в Markdown, чтобы агент мог работать с docs проекта.

tmpdir=$(mktemp -d)
git clone --depth 1 https://github.com/web3blind/getdocs-skill "$tmpdir/getdocs-skill"
mkdir -p ~/.hermes/skills/getdocs
cp -a "$tmpdir/getdocs-skill/." ~/.hermes/skills/getdocs/
rm -rf "$tmpdir"

accessibility-auditor-skill

Аудит доступности сайтов, репозиториев и приложений: WCAG, ГОСТ, screen reader-проверки.

tmpdir=$(mktemp -d)
git clone --depth 1 https://github.com/web3blind/accessibility-auditor-skill "$tmpdir/accessibility-auditor-skill"
mkdir -p ~/.hermes/skills/accessibility-auditor
cp -a "$tmpdir/accessibility-auditor-skill/." ~/.hermes/skills/accessibility-auditor/
rm -rf "$tmpdir"

dashboard-skill

Создание доступных HTML-дашбордов на JSON + localStorage.

tmpdir=$(mktemp -d)
git clone --depth 1 https://github.com/web3blind/dashboard-skill "$tmpdir/dashboard-skill"
mkdir -p ~/.hermes/skills/dashboard
cp -a "$tmpdir/dashboard-skill/." ~/.hermes/skills/dashboard/
rm -rf "$tmpdir"

parallel-orchestrator-skill

Безопасная декомпозиция read-only задач на параллельные subagent-ы.

tmpdir=$(mktemp -d)
git clone --depth 1 https://github.com/web3blind/parallel-orchestrator-skill "$tmpdir/parallel-orchestrator-skill"
mkdir -p ~/.hermes/skills/parallel-orchestrator
cp -a "$tmpdir/parallel-orchestrator-skill/." ~/.hermes/skills/parallel-orchestrator/
rm -rf "$tmpdir"

После ручной установки проверьте:

hermes skills list

В новой сессии можно попросить Hermes явно загрузить навык:

/skill accessibility-auditor

или запустить с предзагрузкой:

hermes -s accessibility-auditor

10. Типовой стартовый сценарий

Если хочется быстро попробовать локально:

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

Если хотите повторить вариант с VPS, короткая цепочка такая:

ssh root@SERVER_IP
apt update && apt upgrade -y
apt install -y curl git python3 python3-venv python3-pip nodejs npm
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes --version
hermes auth add openai-codex --type oauth --no-browser
hermes model
hermes chat

Дальше в чате:

Помоги настроить рабочую среду для Python-проекта. Сначала проверь файлы, потом предложи план, ничего не меняй без объяснения.

Для разработки в конкретной папке:

cd ~/projects/my-project
hermes

11. Решение частых проблем

Команда hermes не найдена

Перезапустите shell или загрузите профиль:

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

Проверьте, где установлен бинарник:

which hermes

Нет ответа от модели

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

hermes doctor
hermes model

Проверьте, что ключи лежат в .env, а не случайно в config.yaml или в истории команд:

hermes config env-path

Инструмент не появился

hermes tools list
hermes tools

После включения toolset начните новую сессию:

/reset

Telegram/gateway не отвечает

hermes gateway status
hermes logs --follow
hermes gateway restart

Если сервис падает после выхода из SSH-сессии на Linux, может понадобиться linger:

sudo loginctl enable-linger $USER

Браузерная автоматизация не работает

Сначала проверьте статус:

hermes doctor
hermes tools list

Если используется Camofox и он не стартует, часто помогает установка браузерных библиотек в системе. На Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y libgtk-3-0 libdbus-glib-1-2 libxt6 libx11-xcb1 \
  libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2 \
  libnss3 libxss1 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libcups2

После изменения config ничего не поменялось

Для CLI — выйдите и запустите заново.

Для gateway:

hermes gateway restart

Для toolsets/skills — начните новую сессию:

/reset

12. Практические советы

Не просите агента сразу “сделай всё”. Лучше: “сначала изучи проект и составь план”.
Для опасных действий просите объяснить последствия до выполнения.
Не храните секреты в промптах, статьях, скриншотах и публичных репозиториях.
Для больших задач используйте skills и делите работу на этапы.
Для доступности интерфейсов проверяйте не только код, но и реальное поведение с TalkBack, NVDA, VoiceOver или Orca.

Полезные ссылки

Hermes Agent: https://github.com/NousResearch/hermes-agent
Документация: https://hermes-agent.nousresearch.com/docs/
Профиль web3blind на GitHub: https://github.com/web3blind
Сайт автора: https://blinddev.xyz/ru

Hermes особенно интересен тем, что это не просто “чат с моделью”, а рабочая среда для задач: от разработки и аудита доступности до исследования документации, автоматизаций и публикации результатов.

48 views·3 shares

48 views