Hermes Agent от Nous Research: установка, настройка, скиллы и SOUL.md

Hermes Agent — ИИ-агент с открытым кодом от Nous Research, который учится на своей работе: после сложных задач сам пишет скиллы, улучшает их по ходу дела, ведёт память о вас и ищет по прошлым разговорам. Код лежит в репозитории NousResearch/hermes-agent под лицензией MIT. На 13.11.2026 у проекта 263 107 звёзд и 59 240 форков на GitHub, последняя версия — v0.23.1 от 10.11.2026.

С агентом говорят в терминале (классический CLI и TUI), в приложении Hermes Desktop, в браузере и в мессенджерах: один процесс-шлюз подключает Telegram, Discord, Slack, WhatsApp, Signal, почту и другие платформы. Встроенный планировщик cron запускает задачи по расписанию, заданному обычными словами, и присылает результат в нужный чат.

Модель выбираете вы: Nous Portal, OpenRouter, OpenAI, Anthropic, свой адрес совместимого API или локальная модель. Меняется она командой hermes model без правки кода. Команды агент выполняет на этом компьютере, в Docker, по SSH, в Modal, Daytona или Vercel Sandbox, поэтому его держат и на VPS за $5, и на кластере с GPU.

На Linux, macOS и в WSL2 Hermes ставится одной командой curl, на Windows без WSL — командой в PowerShell. Скрипт скачивает исходники, ставит uv и через свой менеджер PM подтягивает Python 3.14, Node.js, npm, pnpm, ripgrep, FFmpeg и Chromium для браузерных инструментов. После установки перезагрузите оболочку командой source ~/.bashrc (или source ~/.zshrc) и запустите hermes: интерактивный запуск скрипта сам открывает мастер настройки.

Windows 10 и 11 поддерживаются без WSL: CLI, шлюз, TUI и инструменты работают нативно, права администратора для установки не нужны. Агент ставится в %LOCALAPPDATA%\hermes, команда hermes попадает в PATH пользователя, после установки откройте новый терминал. WSL2 берите, если нужен встроенный терминал вкладки Chat в веб-панели (ему нужен POSIX PTY) или вы и так пишете код внутри WSL. Там работает команда для Linux, данные лежат в ~/.hermes.

Если антивирус помещает в карантин %LOCALAPPDATA%\hermes\bin\uv.exe, это ложное срабатывание на менеджер пакетов uv от Astral. Добавьте в исключения папку bin целиком: хеш файла меняется с каждой версией uv.

Образ Docker nousresearch/hermes-agent собран для amd64 и arm64. Конфиг, ключи, сессии, скиллы и память лежат в папке хоста, смонтированной в /opt/data, поэтому обновляется агент запуском нового образа, hermes update в контейнере не работает. Для Docker Desktop на Windows в репозитории есть docker-compose.windows.yml.

Для Android на aarch64 есть пакет hermes-agent в подписанном APT-репозитории для Termux, скрипт install.sh там не подходит. На 13.11.2026 страница Termux предупреждает, что пакет сейчас не работает и исправление готовят. Шлюз на телефоне живёт в сессии Termux, и Android может остановить его в фоне.

# Linux, macOS, WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows, PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

# после установки
source ~/.bashrc    # или source ~/.zshrc
hermes

# Docker: первый запуск с мастером настройки
mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

Hermes Desktop — то же ядро агента в окне приложения: конфиг, ключи, сессии, скиллы и память у него общие с терминалом. Приложение бесплатное, аккаунт для запуска не нужен. Скачивается оно со страницы hermes-agent.nousresearch.com/desktop: Hermes-Setup.dmg для Mac, для Windows — Microsoft Store или файл Hermes-Setup.exe.

Hermes-Setup — загрузчик: он скачивает исходную версию агента и собирает приложение у вас, на Intel Mac он не запускается. Пакет из Microsoft Store и подписанный MSIX приходят собранными, MSIX требует Windows 11 22H2 или новее. Linux-пакета приложения нет: поставьте агент командой curl и выполните hermes desktop, команда соберёт и откроет приложение. Она же работает после установки из терминала на macOS и Windows и подхватывает текущие настройки.

В браузере Hermes открывается двумя способами. hermes dashboard поднимает веб-панель на http://127.0.0.1:9119: в ней настройки, ключи API, MCP-серверы, сессии, логи, cron и скиллы. Webapp — рабочее место Desktop в браузере, его отдаёт шлюз на порту 9120.

Вошедший в Webapp пользователь может запускать любые команды от имени вашей учётной записи. Для доступа с другой машины нужен вход по паролю или OAuth, а сам адрес держите за SSH-туннелем, Tailscale или VPN.

hermes dashboard                          # веб-панель на 127.0.0.1:9119

hermes config set webapp.enabled true     # Webapp на порту 9120
hermes gateway restart
hermes webapp

Мастер hermes setup на новой установке предлагает три режима. Quick Setup входит в Nous Portal через OAuth и включает модель вместе с Tool Gateway: поиск, картинки, озвучку и облачный браузер. Full Setup проводит по всем провайдерам и инструментам с вашими ключами. Blank Slate оставляет минимум: модель, работу с файлами и терминал.

Если на компьютере найдутся настройки OpenClaw, Claude Code, Codex CLI или Cursor, мастер сначала предложит перенести их через плагин agent-importers.

Провайдера и модель меняет команда hermes model. В таблице быстрого старта 38 вариантов: Nous Portal, OpenRouter, вход по подписке ChatGPT или Codex, Anthropic, Google AI Studio, xAI, DeepSeek, Hugging Face, AWS Bedrock, Ollama Cloud, LM Studio и любой совместимый с OpenAI адрес вроде vLLM, SGLang или Ollama. Модели нужно окно контекста от 64 000 токенов, модель с меньшим окном Hermes отклонит при запуске.

Секреты и токены Hermes хранит в ~/.hermes/.env, остальные настройки — в ~/.hermes/config.yaml. Команда hermes config set сама кладёт значение в нужный файл, hermes config edit открывает config.yaml в редакторе. Если что-то сломалось, начните с hermes doctor.

hermes setup                 # мастер настройки
hermes setup --portal        # вход в Nous Portal одной командой
hermes model                 # выбрать провайдера и модель
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set model anthropic/claude-opus-4.6
hermes --tui                 # первый чат в TUI

Да: код открыт под MIT, Hermes Desktop тоже скачивается и работает бесплатно. Платите вы провайдеру модели, за токены по ключу API или за подписку.

Без затрат агент работает на локальной модели. В Hermes Desktop раздел Settings → Providers → Local Models ставит llama.cpp, подбирает модель под ваше железо и запускает её, в терминале то же делает hermes model → Local models. Ollama подключается как Custom Endpoint с адресом http://localhost:11434/v1, ключ ему не нужен.

У Nous Portal есть тариф Free с оплатой по факту и только бесплатными моделями. Платные тарифы включают поиск, картинки, озвучку, облачный браузер и один облачный агент Hermes Cloud.

У Hugging Face бесплатный уровень с кредитом $0,10 в месяц. Ключ Google AI Studio бесплатного уровня кончается за несколько ходов агента: на один ваш вопрос Hermes делает несколько запросов к модели. Подписка Claude Pro к Hermes не подключается, для Claude нужен ключ ANTHROPIC_API_KEY с оплатой за токены или тариф Max с докупленными кредитами.

Скилл — папка с файлом SKILL.md: имя, описание и пошаговая инструкция. Hermes видит короткие описания всех скиллов и подгружает полный текст, только когда задача его требует, поэтому лишние скиллы не раздувают запрос. Формат совместим с открытым стандартом agentskills.io, так что подходят и скиллы для Claude Code и Codex. Устройство файла разобрано на странице /mcp/skills/skill-md/.

Все скиллы лежат в ~/.hermes/skills/. При установке туда копируются встроенные, на 13.11.2026 их 44: заметки и напоминания Apple, GitHub, Obsidian, PDF, Google Workspace, Microsoft Office и другие. Ещё 141 дополнительный скилл Nous лежит в папке optional-skills и ставится командой hermes skills install official/<категория>/<скилл>. После сложной задачи агент сам сохраняет найденный порядок действий как новый скилл инструментом skill_manage.

Каждый установленный скилл становится командой в чате: /k8s deploy the staging manifest запускает скилл k8s с вашим запросом, /skills в CLI показывает список. Общую папку других агентов, например ~/.agents/skills, подключает ключ skills.external_dirs в config.yaml. Скиллы проекта из .hermes/skills/ и .agents/skills/ в репозитории грузятся после команды hermes skills trust.

Skills Hub ищет сразу в нескольких источниках: дополнительные скиллы Nous (official), skills.sh от Vercel, адреса /.well-known/skills/ на сайтах, репозитории GitHub, ClawHub, LobeHub и browse.sh, а ещё ставит скилл по прямой ссылке на SKILL.md. В каталоге на сайте Hermes Agent у карточек есть кнопка Install in Hermes, она открывает установку в Hermes Desktop. Другие каталоги собраны на странице /mcp/skills/gde-iskat/, готовые скиллы с командами — в разделе /mcp/skills/.

Перед установкой из хаба сканер проверяет скилл на утечку данных, внедрение промптов, разрушительные команды и признаки атаки через зависимости. Флаг --force снимает блокировку при мелких замечаниях, вердикт dangerous он не обходит. hermes skills audit заново проверяет все скиллы из хаба.

hermes skills browse                        # всё, что есть в хабе
hermes skills search kubernetes             # поиск по всем источникам
hermes skills search react --source skills-sh
hermes skills inspect openai/skills/k8s     # посмотреть до установки
hermes skills install openai/skills/k8s     # установка с проверкой
hermes skills install official/security/1password
hermes skills list                          # установленные скиллы
hermes skills check                         # есть ли обновления
hermes skills update

SOUL.md задаёт личность агента: тон, манеру общения, насколько прямо или мягко он отвечает и чего избегает в стиле. Файл лежит в ~/.hermes/SOUL.md (или $HERMES_HOME/SOUL.md), Hermes создаёт заготовку при первом запуске и ставит текст первым в системный промпт вместо встроенного описания. Пустой или удалённый SOUL.md возвращает стандартную личность. Пример первой правки — ниже.

Правила проекта — команды сборки, пути, порты, соглашения по коду — пишите в AGENTS.md в репозитории. Hermes берёт один файл проекта по порядку: .hermes.md, AGENTS.override.md, AGENTS.md, CLAUDE.md, .cursorrules. Внутри Git-репозитория AGENTS.md склеиваются от корня до текущей папки, и файл глубже главнее. Что писать в AGENTS.md и как его читают другие агенты, разобрано на странице /mcp/agents-md/.

Память — два файла в ~/.hermes/memories/: MEMORY.md с заметками о среде и выученных приёмах (до 2 200 знаков) и USER.md с вашим профилем и предпочтениями (до 1 375 знаков). Агент сам правит их инструментом memory, а в промпт они попадают снимком в начале сессии, поэтому новое запомненное видно со следующей сессии. В мессенджерах начинайте новую сессию командой /new после законченной задачи.

You are direct, calm, and technically precise.
Prefer substance over politeness theater.
Push back clearly when an idea is weak.
Keep answers compact unless deeper detail is useful.

MCP-серверы Hermes читает из ~/.hermes/config.yaml, раздел mcp_servers. Локальному серверу нужны command, args и env, удалённому — url и headers. Сервер добавляется командой hermes mcp add, из каталога одобренных Nous серверов через hermes mcp install или правкой файла, после правки выполните /reload-mcp в чате. hermes mcp test <имя> проверит подключение и выведет инструменты сервера.

Готовые конфиги, OAuth, фильтры инструментов и разбор ошибок собраны на странице /mcp/klienty/hermes/, настройки MCP в других агентах — в разделе /mcp/klienty/.

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
  remote_api:
    url: "https://mcp.example.com/mcp"
    headers:
      Authorization: "Bearer ***"

Шлюз — один фоновый процесс, который держит связь со всеми подключёнными платформами, ведёт сессии, запускает задачи cron и доставляет голосовые сообщения. В таблице платформ 28 строк: Telegram, Discord, Slack, WhatsApp, Signal, SMS, почта, Matrix, Mattermost, Microsoft Teams, Google Chat, LINE, Feishu, WeCom, Weixin, QQ, iMessage через BlueBubbles и Photon и другие.

Для Telegram создайте бота у @BotFather, затем выполните hermes gateway setup и выберите Telegram: мастер спросит токен и ID пользователей, которым можно писать боту. Вручную это две строки в ~/.hermes/.env: TELEGRAM_BOT_TOKEN и TELEGRAM_ALLOWED_USERS. В Hermes Desktop и веб-панели есть кнопка Create with QR: отсканируйте код в Telegram, и Hermes сам создаст бота, узнает ваш ID и запишет обе строки.

Шлюз запускает hermes gateway start. hermes gateway install ставит его службой пользователя на Linux, службой launchd на macOS и запланированной задачей на Windows. На сервере шлюз удобно держать в Docker с флагом --restart unless-stopped.

Задачи по расписанию создаются словами в чате или командой hermes cron create, к задаче можно привязать скилл флагом --skill. Результат приходит в чат, откуда задачу поставили, в файл или на выбранную платформу.

hermes gateway setup      # выбрать Telegram, ввести токен и ID
hermes gateway start
hermes gateway status

hermes cron create "every 2h" "Check server status"

# шлюз в Docker на сервере
docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Hermes Agent и OpenClaw — личные агенты, которые живут на вашем компьютере или сервере и отвечают в мессенджерах. Claude Code и Codex — агенты для работы с кодом из терминала, редактора и приложения. Скиллы в формате SKILL.md понимают все четыре.

Из OpenClaw, Claude Code, Codex CLI и Cursor в Hermes переносятся настройки, память и скиллы: выполните hermes plugins install agent-importers, затем hermes import-agent openclaw (или claude-code, codex, cursor). Из OpenClaw переезжают ещё SOUL.md, разрешённые команды и настройки мессенджеров, ключи API — с флагом --migrate-secrets.