Установка

Запустите Hermes Agent менее чем за две минуты с помощью установщика в одну строку.

Быстрая установка

Linux / macOS / WSL2

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

Windows (native, PowerShell) — ранняя бета

:::warning Early BETA Поддержка native Windows находится на стадии ранней беты. Основные сценарии установки и работы уже поддерживаются, но они еще не проверены так же широко, как POSIX-установщики. Если найдете проблему, отправьте ее в issues. Если вам нужен максимально проверенный путь на Windows прямо сейчас, используйте Linux/macOS one-liner выше внутри WSL2. :::

Откройте PowerShell и выполните:

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

Установщик берет на себя все: uv, Python 3.11, Node.js 22, ripgrep, ffmpeg и portable Git Bash. Он клонирует репозиторий в %LOCALAPPDATA%\hermes\hermes-agent, создает virtualenv и добавляет hermes в User PATH. После установки перезапустите терминал или откройте новое окно PowerShell.

Как обрабатывается Git:

Если git уже доступен в PATH, используется существующая установка.
Если нет, установщик скачивает portable PortableGit и распаковывает его в %LOCALAPPDATA%\hermes\git. Права администратора не нужны. Все изолировано и не влияет на системный Git.

Установщик также задает HERMES_GIT_BASH_PATH, чтобы Hermes однозначно находил bash.exe в новых shell-сессиях.

Если вы предпочитаете WSL2, Linux-установщик выше нормально работает и там. Native и WSL-установка могут сосуществовать без конфликтов: native-данные лежат в %LOCALAPPDATA%\hermes, а WSL-данные — в ~/.hermes.

Android / Termux

Hermes теперь поддерживает и путь установки с учетом Termux:

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

Установщик автоматически определяет Termux и переключается на проверенный Android flow:

использует pkg Termux для системных зависимостей (git, python, nodejs, ripgrep, ffmpeg, build tools)
создает virtualenv через python -m venv
автоматически экспортирует ANDROID_API_LEVEL для сборки Android wheel
сначала предпочитает .[termux-all], а если сборка не проходит, откатывается к .[termux], а затем к базовой установке
по умолчанию пропускает непроверенный bootstrap браузера / WhatsApp

Если нужен полностью явный сценарий, используйте отдельный guide по Termux.

:::note Windows Feature Parity (Early Beta) Native Windows находится в ранней бете. На Windows нативно работает почти все, кроме browser-based terminal pane внутри dashboard /chat:

CLI (hermes chat, hermes setup, hermes gateway, …) — работает нативно
Gateway (Telegram, Discord, Slack, …) — работает нативно как фоновый PowerShell-процесс
Cron scheduler — работает нативно
Browser tool — работает нативно через Chromium/Node.js
MCP servers — работают нативно, и через stdio, и через HTTP
Dashboard /chat terminal pane — только через WSL2, потому что использует POSIX PTY

Если столкнетесь с проблемой кодировки, можно задать HERMES_DISABLE_WINDOWS_UTF8=1, чтобы временно вернуться к legacy cp1252 stdio path. :::

Что делает установщик

Установщик автоматически настраивает все: зависимости, клонирование репозитория, virtual environment, глобальную команду hermes и конфигурацию LLM-провайдера. В конце вы сразу готовы к работе с агентом.

Схема установки

Расположение файлов зависит от того, запускаете вы установку как обычный пользователь или как root:

Установщик	Где лежит код	Бинарник `hermes`	Каталог данных
Per-user (обычный режим)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes` (symlink)	`~/.hermes/`
Root-mode (`sudo curl ... \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/` (или `$HERMES_HOME`)

Root-mode использует FHS layout (/usr/local/lib/..., /usr/local/bin/hermes), как и другие системные developer tools на Linux. Это удобно для shared-machine deployment, где одна системная установка должна обслуживать всех пользователей. Пользовательские настройки, авторизация, навыки и сессии при этом по-прежнему живут в ~/.hermes/ или в явно заданном HERMES_HOME.

После установки

Перезагрузите shell и запускайте Hermes:

source ~/.bashrc   # или: source ~/.zshrc
hermes             # Начать диалог

Позже отдельные настройки можно менять специальными командами:

hermes model          # Выбрать LLM-провайдера и модель
hermes tools          # Настроить включенные инструменты
hermes gateway setup  # Настроить платформы обмена сообщениями
hermes config set     # Установить отдельные значения конфигурации
hermes setup          # Либо запустить полный мастер настройки

Требования

Единственное обязательное требование — Git. Все остальное установщик настроит сам:

uv (быстрый менеджер Python-пакетов)
Python 3.11
Node.js v22
ripgrep
ffmpeg

Вам не нужно вручную ставить Python, Node.js, ripgrep или ffmpeg. Установщик сам определяет, чего не хватает, и ставит недостающие компоненты. Достаточно, чтобы работал git --version.

:::tip Nix users Если вы используете Nix на NixOS, macOS или Linux, для него есть отдельный путь настройки с Nix flake, декларативным модулем NixOS и опциональным container mode. См. Nix & NixOS Setup. :::

Ручная / developer-установка

Если вы хотите клонировать репозиторий и установить проект из исходников, например для вклада в проект, запуска из конкретной ветки или полного контроля над virtual environment, смотрите раздел Development Setup в гайде по contribution.

Устранение неполадок

Проблема	Решение
`hermes: command not found`	Перезагрузите shell (`source ~/.bashrc`) или проверьте PATH
`API key not set`	Выполните `hermes model` для настройки провайдера или `hermes config set OPENROUTER_API_KEY your_key`
Missing config after update	Выполните `hermes config check`, затем `hermes config migrate`

Для дополнительной диагностики используйте hermes doctor: он покажет, чего именно не хватает и как это исправить.