Installation
На этой странице Запустите Hermes Agent за две минуты с помощью однострочного инсталлятора.
Быстрая установка¶
Linux / macOS / WSL2¶
[code] curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
[/code]
Android / Termux¶
Hermes теперь также включает установщик, совместимый с Termux: [code] curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
[/code]
Установщик автоматически определяет Termux и переключается на проверенный Android-сценарий:
* использует pkg из Termux для системных зависимостей (git, python, nodejs, ripgrep, ffmpeg, инструменты сборки)
* создаёт виртуальное окружение через python -m venv
* автоматически экспортирует ANDROID_API_LEVEL для сборки Android-пакетов
* устанавливает подобранный экстра .[termux] через pip
* пропускает непроверенный начальный bootstrap браузера / WhatsApp по умолчанию
Если вы предпочитаете полностью явный путь, следуйте специальному руководству по Termux. Windows Нативная Windows не поддерживается. Пожалуйста, установите WSL2 и запускайте Hermes Agent оттуда. Команда установки выше работает внутри WSL2.
Что делает установщик¶
Установщик обрабатывает всё автоматически — все зависимости (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.
После установки¶
Перезагрузите оболочку и начинайте общение:
[code]
source ~/.bashrc # или: source ~/.zshrc
hermes # Начать общение!
[/code]
Чтобы позже изменить отдельные настройки, используйте соответствующие команды:
[code]
hermes model # Выбрать LLM-провайдера и модель
hermes tools # Настроить, какие инструменты включены
hermes gateway setup # Настроить мессенджер-платформы
hermes config set # Установить отдельные значения конфигурации
hermes setup # Или запустите мастер настройки для конфигурации всего сразу
[/code]
Предварительные требования¶
Единственное предварительное требование — Git. Всё остальное установщик обрабатывает автоматически: * uv (быстрый менеджер пакетов Python) * Python 3.11 (через uv, sudo не требуется) * Node.js v22 (для автоматизации браузера и моста WhatsApp) * ripgrep (быстрый поиск по файлам) * ffmpeg (конвертация аудиоформатов для TTS)
info
Вам не нужно устанавливать Python, Node.js, ripgrep или ffmpeg вручную. Установщик определяет, чего не хватает, и устанавливает это за вас. Просто убедитесь, что git доступен (git --version).
Пользователи Nix
Если вы используете Nix (на NixOS, macOS или Linux), существует отдельный путь установки с Nix-флейком, декларативным модулем NixOS и опциональным контейнерным режимом. См. руководство Nix и NixOS Setup.
Ручная / разработческая установка¶
Если вы хотите клонировать репозиторий и установить из исходников — для участия в разработке, работы с определённой веткой или полного контроля над виртуальным окружением — см. раздел Настройка окружения для разработки в руководстве по участию.
Устранение неполадок¶
| Проблема | Решение |
|---|---|
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 — он покажет, чего именно не хватает и как это исправить. |
|
| * Быстрая установка | |
| * Linux / macOS / WSL2 | |
| * Android / Termux | |
| * Что делает установщик | |
| * После установки | |
| * Предварительные требования | |
| * Ручная / разработческая установка | |
| * Устранение неполадок |