Hermes — мозг агентного воркспейса | Установка, состав и восстановление

Fractera — это Agentic Engineering Infrastructure: защищённый self-hosted воркспейс, где ИИ-модели пишут и запускают твоё приложение на твоём собственном сервере. В его центре — Hermes, оркестрирующий мозг. Этот документ простыми словами объясняет, из чего Hermes состоит, как он поднимается на свежем сервере и как восстановить его, если его удалили. Он написан так, чтобы его читал и технический человек, и ИИ-агент — это запись для непрерывности, чтобы знание не жило только в чьей-то голове.

Кто такой Hermes — мозг, а не руки

Hermes оркеструет; код твоего приложения он не печатает. Реальный код пишут пять кодеров, у каждого свой терминал в приложении. Задача Hermes — выбрать подходящего агента, проверить готовность, делегировать задачу и вести всё вокруг кода: настройки, журнал развёртываний, память компании. Он — один из агентов мультиагентного воркспейса; тот самый, что дирижирует.

Из чего состоит Hermes

Hermes — не один бинарь, который включаешь тумблером, а небольшой набор частей, у каждой свой чёткий дом. Знание этих частей и делает его восстановимым.

Поверхность     Порт    Процесс                  Роль
--------------------------------------------------------------
Дашборд агента  :9119   fractera-hermes          мозг + панель управления
Чат Web UI      :9120   fractera-hermes-webui    дружелюбный встроенный чат
Шлюз            —       fractera-hermes-gateway  Telegram/мессенджеры + cron

Компонент       Где живёт (/root/.hermes/)
--------------------------------------------------------------
Личность        SOUL.md            <- кто он + его место в архитектуре
Навыки          skills/<name>/SKILL.md   <- по папке на навык, с frontmatter
Плагины         plugins/
Конфиг          config.yaml        <- mcp_servers (мосты-инструменты) + модель
MCP-мосты       readiness, deployments, app-settings, drafts, ...

Как он поднимается на свежем сервере

На каждом развёртывании установочный скрипт раскладывает Hermes из субстрата и запускает его процессы — так что свежий сервер получает рабочий мозг без ручных шагов.

установить плагины   -> /root/.hermes/plugins/
установить навыки    -> /root/.hermes/skills/<name>/SKILL.md   (папки, не плоские файлы)
установить SOUL.md   -> личность Fractera + самоосознание архитектуры
старт агента         -> дашборд на 127.0.0.1:9119  (НЕ 0.0.0.0)
старт шлюза          -> мессенджеры + cron
установить web UI    -> чат на :9120
сохранить процессы   -> переживает перезагрузку

Где живут навыки и MCP — и как их зеркалит /ai-core

Это та самая часть, что нас и подвела, — стоит увидеть движение данных. Навык — это папка `<name>/SKILL.md` с маленькой шапкой (имя и описание, когда его применять). Одна каноническая копия лежит в общей папке `.agents/skills`, которую два агента читают напрямую; остальные кодеры держат копию в своей папке; а Hermes держит свою копию в субстрате воркспейса, который шаг установки на каждом деплое раскладывает в его дом. MCP (инструмент, который агент вызывает) — это процесс-мост плюс однострочная регистрация в MCP-конфиге каждого агента. Поток целиком:

ПОЖЕЛАНИЕ               →  ШАГ               →  МАТЕРИАЛИЗАЦИЯ (пишем файлы)        →  ЗЕРКАЛО
архитектор/агент пишет     черновики собраны     агент пишет способность в               /ai-core заново
черновик на странице       в один шаг            каноническую форму для КАЖДОГО          читает диск и
AI Draft Settings                                агента:                                 показывает живой
(реальный файл не трогаем)                       - навык -> <name>/SKILL.md (+ копии     каталог
                                                          + субстрат Hermes)
                                                 - mcp   -> мост + регистрация в
                                                          MCP-конфиге каждого агента
                                                 - инстр.-> корневой файл агента
                                                          (SOUL.md у Hermes)

Каталог, который ты реально листаешь, — это страница `/ai-core` внутри воркспейса (только для архитектора): она живое зеркало — при каждом открытии заново читает реальные файлы на диске и строит дерево, поэтому всегда показывает то, что действительно установлено на ЭТОМ сервере (на публичном сайте есть и витрины только для чтения). Одно правило держит это честным: формат на диске, сканер, который его читает, и шаг установки, который его кладёт, обязаны совпадать. Наш сбой был ровно рассогласованием — навыки перевели в папки, а зеркало всё ещё искало плоские файлы, и навыки Hermes показывались пустыми. Одна форма везде чинит это навсегда.

Три вещи, которые тебя укусят

1. Бинд 127.0.0.1, никогда 0.0.0.0. Hardening июня-2026 отказывает в публичном бинде без провайдера авторизации, а старый флаг-обход теперь мёртв. Публичный бинд уводит агента в краш-цикл, порт не открывается, прокси отдаёт 502.
2. Прокси обязан слать агенту Host: 127.0.0.1. Тот же hardening проверяет заголовок Host против адреса бинда; публичный хост отвергается с «Invalid Host header». Это нужно только локации самого агента — чат и авторизация остаются как есть.
3. Навыки — папки, а не плоские файлы. Hermes открывает навык только как папку с SKILL.md внутри (плюс frontmatter). Голый markdown-файл невидим, и агент молча выберет не тот навык.

Полезная примета: если чат (:9120) отвечает, а вкладка агента даёт 502 — это два разных процесса; живой чат не значит живой агент. Сначала проверь процесс агента и его лог.

Восстановление — как вернуть Hermes

Полное восстановление — это просто свежий деплой: всё нужное Hermes есть в субстрате и едет с установкой. Частичное — Hermes снесли, а сервер жив — это переустановка его частей из субстрата (навыки папками, SOUL.md, плагины, конфиг), затем перезапуск агента (бинд 127.0.0.1), шлюза и чата и сохранение списка процессов. Доказательство, что получилось: список навыков показывает твои навыки как enabled, агент отвечает на своём порту, а процесс больше не перезапускается.

Быстро исправляйте допущенные ошибки. Если вы постоянно экспериментируете, то таких ошибок будет много. Если вы их вовремя исправляете, то катастрофы не произойдёт.