🏠 Главная › Документация › Начало работы

Установка

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

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

Linux / macOS / WSL2

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

Windows (нативный, PowerShell) — Ранняя бета

warning Ранняя БЕТА Поддержка нативной Windows находится в ранней бета-версии. Она устанавливается и работает для стандартных путей, но не прошла такого же широкого тестирования, как наши POSIX-установщики. Пожалуйста, создавайте issues, если столкнетесь с проблемами. Для наиболее проверенной настройки на Windows сегодня используйте однострочную команду для Linux/macOS выше внутри WSL2.

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

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

Установщик берет на себя всё: uv, Python 3.11, Node.js 22, ripgrep, ffmpeg, и портативный Git Bash (PortableGit — автономный дистрибутив Git для Windows, включающий bash.exe и полный POSIX-инструментарий, который Hermes использует для shell-команд; на 32-битной Windows установщик использует MinGit, в котором нет bash, что отключает функции терминального инструмента и браузера агента). Он клонирует репозиторий в %LOCALAPPDATA%\hermes\hermes-agent, создает виртуальное окружение и добавляет hermes в ваш User PATH. Перезапустите терминал (или откройте новое окно PowerShell) после установки, чтобы PATH обновился.

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

  1. Если git уже есть в PATH, установщик использует вашу существующую установку.

  2. В противном случае он загружает портативный PortableGit (~50 МБ, из официального релиза git-for-windows на GitHub) и распаковывает его в %LOCALAPPDATA%\hermes\git. Права администратора не требуются. Полностью изолирован — он не будет мешать системной установке Git, сломанной или нет. (На 32-битной Windows используется MinGit, так как PortableGit поставляется только в 64-битной и ARM64-сборках; функции Hermes, зависящие от bash, не будут работать на 32-битных системах.)

Почему не winget? В предыдущих версиях Git устанавливался через winget install Git.Git, но winget серьезно сбоит, когда системная установка Git находится в частичном или сломанном состоянии (именно тогда пользователям нужен установщик, который просто работает). Портативный Git обходит winget, реестр установщика Windows и любую существующую системную установку Git. Если установка Git в Hermes когда-либо сломается, выполните Remove-Item %LOCALAPPDATA%\hermes\git и запустите установщик заново — никакого влияния на систему, никакой драмы с удалением.

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

Если вы предпочитаете WSL2, установщик для Linux выше работает внутри него; обе установки (нативная и WSL) могут сосуществовать без конфликтов (нативные данные находятся в %LOCALAPPDATA%\hermes, данные WSL — в ~/.hermes).

Android / Termux

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

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

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

Если вы хотите полностью явный путь, следуйте специальному руководству по Termux.

note Windows Feature Parity (Early Beta)

Нативная Windows находится в ранней бета-версии. Всё, кроме панели чата на базе браузера в дашборде, работает на Windows нативно:

Установите HERMES_DISABLE_WINDOWS_UTF8=1 в переменных окружения, если вы столкнулись с ошибкой кодировки и хотите вернуться к устаревшему пути stdio cp1252 (полезно для диагностики).

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

Установщик обрабатывает всё автоматически — все зависимости (Python, Node.js, ripgrep, ffmpeg), клонирование репозитория, виртуальное окружение, настройку глобальной команды hermes и конфигурацию LLM-провайдера. По завершении вы готовы к общению.

Структура установки

Куда установщик помещает файлы, зависит от того, устанавливаете ли вы как обычный пользователь или как root:

Установщик Код находится в Бинарник hermes Директория данных
Пользовательский (обычный) ~/.hermes/hermes-agent/ ~/.local/bin/hermes (симлинк) ~/.hermes/
Root-режим (sudo curl … \| sudo bash) /usr/local/lib/hermes-agent/ /usr/local/bin/hermes /root/.hermes/ (или $HERMES_HOME)

Root-режим использует FHS-структуру (/usr/local/lib/…, /usr/local/bin/hermes), что соответствует расположению других общесистемных инструментов разработчика на Linux. Это полезно для развертываний на общих машинах, где одна системная установка должна обслуживать всех пользователей. Пользовательская конфигурация (авторизация, навыки, сессии) по-прежнему хранится в ~/.hermes/ каждого пользователя или в явно указанном HERMES_HOME.

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

Перезагрузите ваш shell и начинайте общаться:

source ~/.bashrc   # или: source ~/.zshrc
hermes             # Начинайте общение!

Чтобы позже перенастроить отдельные параметры, используйте соответствующие команды:

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

Предварительные требования

Единственное предварительное требование — Git. Установщик автоматически обрабатывает всё остальное:

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

tip Пользователям Nix Если вы используете Nix (на NixOS, macOS или Linux), существует специальный путь установки с Nix flake, декларативным модулем NixOS и опциональным режимом контейнера. Смотрите руководство Настройка Nix & NixOS.

Ручная / разработческая установка

Если вы хотите клонировать репозиторий и установить из исходного кода — для внесения вклада, работы с определённой ветки или полного контроля над виртуальным окружением — смотрите раздел Настройка окружения разработки в руководстве по участию в разработке.

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

Проблема Решение
hermes: команда не найдена Перезагрузите shell (source ~/.bashrc) или проверьте PATH
API key not set Выполните hermes model для настройки провайдера или hermes config set OPENROUTER_API_KEY ваш_ключ
Отсутствует конфигурация после обновления Выполните hermes config check, затем hermes config migrate

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