Как удалить Hermes Agent с компьютера или сервера

Коротко. Hermes Agent удаляется командой hermes uninstall. Перед этим выполните её с флагом --dry-run: программа покажет, что будет удалено, и ничего не тронет. По умолчанию удаление может оставить ваши настройки и данные, флаг --data удаляет данные, --full удаляет всё. Если шлюз работал как служба, его нужно остановить заранее. Приложение, поставленное как пакет Windows или macOS, удаляется средствами системы. Ниже порядок действий для каждого варианта и как сохранить копию данных. Проверено по документации Hermes Agent 22 октября 2026 года.

Не хотите разбираться в вариантах? Выберите, как вы устанавливали Hermes и что делать с данными, и получите команды в нужном порядке:

Что вы удаляете

У Hermes два вида содержимого:

• программа: код и команда hermes;
• данные: файл с ключами .env, настройки config.yaml, память, навыки, сессии, журналы, задачи по расписанию.

Данные по умолчанию лежат в ~/.hermes на Linux и macOS и в %LOCALAPPDATA%\hermes на Windows. Если вы задавали переменную HERMES_HOME, ищите там. Решите заранее, нужны ли вам данные, и сделайте копию, если не уверены.

Шаг 1. Сохраните копию данных (если нужно)

hermes backup

Команда собирает архив. В нём есть учётные данные (ключи), поэтому храните файл как пароль. Если Hermes потом понадобится на другой машине, восстановить архив можно командой hermes import архив.zip. Для одного профиля есть hermes profile export, ключи в экспорт не попадают.

Шаг 2. Остановите шлюз

Если вы запускали шлюз как службу (Telegram и другие мессенджеры), остановите его:

hermes gateway stop

Затем отключите автозапуск. Linux: systemctl --user disable hermes-gateway. macOS: launchctl remove ai.hermes.gateway.

Шаг 3. Удалите программу

Если ставили скриптом или командой установки (Windows PowerShell, Linux, macOS, WSL2):

hermes uninstall --dry-run

Команда покажет, что будет удалено. Если всё верно, выполните:

hermes uninstall

Режим	Что удаляется
hermes uninstall	Программа; конфигурация и данные могут остаться
hermes uninstall --data	Только ваши данные, код остаётся
hermes uninstall --full	И программа, и данные
hermes uninstall --gui	Собранное из исходников десктоп-приложение
--dry-run	Только показать, ничего не удаляя
--yes	Не спрашивать подтверждение

Режимы с удалением данных разрушительны, документация советует сделать резервную копию заранее. Перед удалением данных остановите процессы Hermes.

Если команда hermes не запускается, на Linux и macOS можно удалить вручную (команды из документации):

rm -f ~/.local/bin/hermes
rm -rf /путь/к/hermes-agent
rm -rf ~/.hermes    # по желанию: оставьте, если планируете вернуться

Если вы не удаляете, а переезжаете

Часто удаление нужно, чтобы перенести агента на другой компьютер или сервер. Тогда данные удалять не нужно, а наоборот сохранить:

1. На старой машине выполните hermes backup (архив содержит учётные данные, храните его как пароль).
2. Установите Hermes на новой машине (Windows, сервер в Docker).
3. Восстановите данные: hermes import архив.zip.
4. Проверьте hermes doctor и подключения мессенджеров, а на старой машине остановите шлюз, чтобы два шлюза не работали с одним токеном.

Если нужно перенести только один профиль, используйте hermes profile export и hermes profile import: учётные данные при этом в экспорт не попадают.

Если Hermes установлен как приложение

• Windows (пакет MSIX или Microsoft Store): откройте Параметры, Приложения, Установленные приложения, найдите Hermes и удалите.
• macOS: закройте Hermes и перенесите приложение в корзину.
• Docker, Nix, Termux: удаляются тем же менеджером, которым ставились. Деинсталлятор из исходников их файлы не трогает. Для Docker это остановка и удаление контейнера и образа командами Docker, например docker rm -f hermes (подробности по контейнерам в статье «Hermes Agent на VPS в Docker»).

Что проверить после удаления

Документация не описывает, какие записи PATH остаются после удаления, поэтому проверьте сами:

• команда hermes больше не находится (в PowerShell Get-Command hermes, в Linux и macOS which hermes);
• на Linux и macOS нет ссылки ~/.local/bin/hermes;
• не осталось запущенных процессов и службы шлюза (на Linux systemctl --user status hermes-gateway);
• папка данных удалена или, наоборот, сохранена, как вы решили.

Чего не делать

• Не удаляйте папку данных вручную, чтобы «починить» установку. Документация прямо предупреждает: для ремонта приложения не стоит удалять корневую папку данных. Сначала выполните hermes doctor, потом hermes update.
• Не забывайте про службу шлюза. Остановите её до удаления (шаг 2), иначе она может остаться в автозапуске.
• Не забудьте про токен бота. Если вы удаляете Hermes насовсем, отзовите токен Telegram-бота командой /revoke в BotFather и удалите бота: так никто не воспользуется забытым токеном.

Как переустановить с нуля

Если задача была не удалить, а начать заново, достаточно hermes uninstall --full, а затем снова команды установки (см. «Установка Hermes Agent на Windows»). Если хотите сохранить память и навыки, используйте hermes uninstall без --full, и установите заново. По документации конфигурация и данные при этом могут остаться, проверьте это предпросмотром --dry-run.

Частые вопросы

Остаются ли мои данные после hermes uninstall? По умолчанию конфигурация и данные могут остаться. Для удаления данных используйте --data или --full.

Как проверить, что будет удалено? Выполните hermes uninstall --dry-run. Он ничего не меняет.

Как удалить Hermes на Windows? Если ставили командой PowerShell, используйте hermes uninstall. Если приложением, удаляйте через Параметры, Приложения.

Что с ключами и токенами? Они лежат в .env в папке данных. Перед удалением сохраните копию, если планируете вернуться, а токен бота отзовите, если не планируете.

Источники и дата проверки

Данные проверены 22 октября 2026 года:

• Документация Hermes: обновление и удаление
• Документация Hermes: справочник команд
• Документация Hermes: Hermes на Windows

Материал независимый: учебный центр «Альма Матер» не связан с разработчиками упомянутых программ и сервисов. Названия принадлежат их владельцам.