Установщик автоматически обнаруживает Termux и переключается на проверенный поток Android:
- использует Termux pkg для системных зависимостей (git, python, nodejs, ripgrep, ffmpeg, инструменты сборки)
- создает виртуальную среду с помощью python -m venv
- автоматически экспортирует ANDROID_API_LEVEL для сборок Android Wheel
- устанавливает специальное дополнение .[termux] с pip
- по умолчанию пропускает непроверенный браузер/загрузку WhatsApp
Если вам нужен полностью явный путь, следуйте специальному [руководству по Termux] (./termux.md).
::: предупреждение Windows
Родная версия Windows не поддерживается. Пожалуйста, установите WSL2 и запустите агент Hermes оттуда. Приведенная выше команда установки работает внутри WSL2.
Что делает установщик
Установщик выполняет все автоматически — все зависимости (Python, Node.js, ripgrep, ffmpeg), клон репозитория, виртуальную среду, глобальную настройку команды hermes и конфигурацию поставщика LLM. В конце концов, вы готовы к общению.
Установка макета
Куда помещает установщик, зависит от того, выполняете ли вы установку как обычный пользователь или как root:
Установщик
Код живет по адресу
hermes двоичный
Каталог данных
Для каждого пользователя (обычный)
~/.hermes/hermes-agent/
~/.local/bin/hermes (символическая ссылка)
~/.hermes/
Корневой режим (sudo curl … \| sudo bash)
/usr/local/lib/hermes-agent/
/usr/local/bin/hermes
/root/.hermes/ (или $HERMES_HOME)
Раскладка FHS корневого режима** (/usr/local/lib/…, /usr/local/bin/hermes) соответствует тому, где находятся другие общесистемные инструменты разработчика в Linux. Это полезно для развертываний на общих машинах, где одна установка системы должна обслуживать каждого пользователя. Индивидуальная конфигурация пользователя (аутентификация, навыки, сеансы) по-прежнему хранится под ~/.hermes/ или явным HERMES_HOME каждого пользователя.
Чтобы изменить отдельные настройки позже, используйте специальные команды:
hermesmodel# Choose your LLM provider and model
hermestools# Configure which tools are enabled
hermesgatewaysetup# Set up messaging platforms
hermesconfigset# Set individual config values
hermessetup# Or run the full setup wizard to configure everything at once
Предварительные условия
Единственное необходимое условие — Git. Установщик автоматически обрабатывает все остальное:
uv (быстрый менеджер пакетов Python)
Python 3.11 (через uv, sudo не требуется)
Node.js v22 (для автоматизации браузера и моста WhatsApp)
ripgrep (быстрый поиск файлов)
ffmpeg (преобразование аудиоформата для TTS)
:::информация
Вам не нужно устанавливать Python, Node.js, ripgrep или ffmpeg вручную. Установщик обнаружит, чего не хватает, и установит это за вас. Просто убедитесь, что git доступен (git --version).
:::совет пользователям Nix
Если вы используете Nix (в NixOS, macOS или Linux), существует специальный путь установки с флэш-версией Nix, декларативным модулем NixOS и дополнительным режимом контейнера. См. руководство Настройка Nix и NixOS.
Руководство / Установка разработчика
Если вы хотите клонировать репозиторий и установить из исходного кода — для участия, запуска из определенной ветки или полного контроля над виртуальной средой — см. раздел Настройка разработки в руководстве «Содействие».
Устранение неполадок
Проблема
Решение
hermes: command not found
Перезагрузите оболочку (source ~/.bashrc) или проверьте PATH
API key not set
Запустите hermes model, чтобы настроить своего провайдера, или hermes config set OPENROUTER_API_KEY your_key
Отсутствует конфигурация после обновления
Запустите hermes config check, затем hermes config migrate
Для дополнительной диагностики запустите hermes doctor — она точно скажет вам, чего не хватает и как это исправить.