🏠 Главная › getting started › installation

Установка

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

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

Linux/macOS/WSL2

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

Windows (родной, PowerShell) — Ранняя бета

⚠️ Warning

Ранняя бета

Поддержка нативного Windows — ранняя бета. Она настроена и работает обычными способами, но не прошла такого широкого тестирования, как наши POSIX-установщики. Пожалуйста, сообщайте о проблемах, когда сталкиваетесь с шероховатостью. Для наиболее проверенной настройки на 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-for-Windows, которая представляет bash.exe и полный POSIX-инструментарий, аналогичный Hermes для командной оболочки; на 32-битных Windows установщик переключается на MinGit, в котором нет bash, и отключает функции терминала-инструмента/агента-браузера). Он клонирует репозиторий в %LOCALAPPDATA%\hermes\hermes-agent, создает virtualenv и добавляет 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 мог детерминированно найти его в новых оболочках.

Если вы предпочитаете 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-поток: - использует pkg из Termux для системных зависимостей (git, python, nodejs, ripgrep, ffmpeg, инструменты сборки) - Создаем virtualenv с помощью python -m venv - автоматически экспортирует ANDROID_API_LEVEL для сборки Android-колес - отдавайте предпочтение широкому расширению .[termux-all] и переключается на меньший .[termux] (и, наконец, на базовую установку), если первая попытка не компилируется - по умолчанию пропускает непроверенную загрузку браузера / WhatsApp

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

📝 Note

Паритет функций Windows (Ранняя бета)

Родная Windows находится в ранней бета-версии. Всё, кроме терминальной панели чата на основе браузера, работает нативно на Windows: - CLI (гермес-чат, гермес-настройка, гермес-шлюз, …) — нативно, использует ваш терминал по умолчанию - Шлюз (Telegram, Discord, Slack, …) — нативно, работает как фоновый процесс PowerShell - Планировщик Cron — нативно - Инструмент браузера — нативно (Chromium через Node.js) - MCP-серверы — нативно (поддерживаются как stdio, так и HTTP-транспорты) - Панель терминала /chat в Dashboard — только WSL2 (используется POSIX PTY; родной Windows не имеет эквивалента). Остальная часть Dashboard (сессии, задания, метрики) работает нативно — только встроенная вкладка PTY-терминала ограничена.

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

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

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

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

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

Установщик Код находится в Бинарник Гермес Директория данных
Для пользователя (обычный) ~/.hermes/гермес-агент/ ~/.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.

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

Перезагрузите оболочку и начните чат:

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

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

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

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

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

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

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

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

Проблема Решение
гермес: команда не найдена Перезагрузите оболочку (source ~/.bashrc) или проверьте PATH
Ключ API не установлен Запустите hermes model для настройки провайдера или hermes config set OPENROUTER_API_KEY your_key
Отсутствует изменение после обновлений Запустите Проверка конфигурации Гермеса, затем Перенос конфигурации Гермеса

Для дополнительного диагноза запустите «доктор Гермес» — он скажет вам точно, чего не хватает и как это исправить.