Добро пожаловать в самую простую установку в вашей жизни

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

Самый быстрый путь: Hermes Desktop

Для пользователей macOS и Windows самый простой способ — скачать установщик Hermes Desktop с нашего сайта. Скачайте, запустите — и готово. Он устанавливает и командную строку, и десктопное приложение, так что вы получаете лучшее из двух миров.

Только командная строка? Без проблем

Предпочитаете оставаться в терминале? У вас есть два варианта в зависимости от ОС:

Linux / macOS / WSL2 / Android (Termux):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (нативно) — запустите в PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Передумали и хотите потом десктопное приложение? Просто выполните hermes desktop — и он сделает всё остальное.

Что на самом деле делает установщик (чтобы вам не пришлось)

Вот в чём магия: установщик автоматически настраивает всё. Никакого больше ручного поиска зависимостей по одной. Он устанавливает:

Python 3.11 (через uv, без sudo)
Node.js v22 (для автоматизации браузера и WhatsApp-моста)
ripgrep (для молниеносного поиска по файлам)
ffmpeg (для преобразования аудио в TTS)
Клонирование репозитория, виртуальное окружение и глобальную команду hermes

Единственное, что вам нужно установить самостоятельно, — это Git (проверьте командой git --version). На Linux также убедитесь, что доступны curl и xz-utils. Для десктопного приложения на Debian/Ubuntu понадобится build-essential.

Куда всё устанавливается

В зависимости от способа установки файлы попадают в разные места:

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

Root-режим идеально подходит для общих машин, где одна системная установка обслуживает всех. Ваши личные настройки (авторизация, навыки, сессии) по-прежнему безопасно хранятся в вашей собственной папке ~/.hermes/.

После установки: начинайте общение!

Когда установщик закончит работу, перезагрузите оболочку и вперёд:

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

Хотите что-то настроить позже? Для этого есть специальные команды:

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

Самый быстрый путь: Nous Portal

Профессиональный совет: если хотите полностью избежать возни с API-ключами для каждого инструмента, используйте Nous Portal. Одна подписка покрывает 300+ моделей плюс Tool Gateway (веб-поиск, генерация изображений, TTS, облачный браузер). Всё настраивается одной командой:

hermes setup --portal

Это войдёт в систему, установит Nous как провайдера и включит Tool Gateway — всё разом.

Переезд с другой машины?

Не собирайте всё с нуля. Восстановите полный бэкап с помощью hermes import или перенесите отдельного агента через hermes profile import. Просто помните: экспорт профилей по дизайну не включает учётные данные, так что для настоящего бэкапа используйте hermes backup.

Примечание для пользователей Nix

Nix больше не является официально поддерживаемым способом установки (только по мере возможности). Если вы уже используете Nix, есть отдельное руководство по настройке с flake и NixOS-модулем — смотрите документацию Nix & NixOS Setup.

Запуск как системный сервис?

Хотите запускать Hermes как отдельного непривилегированного пользователя (например, системный аккаунт hermes)? Полностью поддерживается. Единственный шаг, требующий root, — это --with-deps у Playwright для библиотек Chromium. Установщик сам определяет, доступен ли sudo, и аккуратно это обрабатывает.

Вот и всё! Теперь вы готовы начать свой первый разговор с Hermes. В следующем руководстве мы исследуем ваш первый чат-сеанс и все классные вещи, которые можно делать. Увидимся там!