Быстрый старт

С нуля до рабочей установки Hermes, которая выдержит настоящую эксплуатацию. Поставить, выбрать провайдера модели, убедиться, что чат отвечает, и точно знать, что делать, когда что-то отвалится. Этого хватит, чтобы запустить автономный ИИ-агент и сразу начать с ним работать.

Удобнее посмотреть видео?

Команда Onchain AI Garage собрала мастер-класс по установке, настройке и базовым командам — хорошее дополнение к этой странице, если вам ближе формат видео. Больше материалов — в полном плейлисте Hermes Agent Tutorials & Use Cases.

Кому это пригодится

• Новичкам, которым нужен кратчайший путь к рабочей установке
• Тем, кто меняет провайдера и не хочет терять время на ошибки в конфиге
• Тем, кто настраивает Hermes для команды, бота или процесса в режиме 24/7
• Тем, кому надоело «установилось, но всё равно ничего не делает»

Самый быстрый маршрут

Найдите строку, которая совпадает с вашей целью:

Простое правило: если Hermes не доводит до конца обычный разговор, новые возможности пока не трогайте. Сперва добейтесь одной чистой беседы, и уже потом наслаивайте шлюз, cron, навыки, голос или маршрутизацию.

1. Установите Hermes Agent

Через установщик Hermes Desktop на macOS или Windows (рекомендуется)

Чтобы легко поставить и консольное, и десктопное приложение, скачайте установщик Hermes Desktop с сайта и запустите.

Без 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) 

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

source ~/.bashrc   # или source ~/.zshrc

Подробные опции установки, требования и решение проблем — в руководстве по установке.

2. Выберите провайдера

Самый важный шаг настройки. Команда hermes model проведёт по выбору в интерактивном режиме:

hermes model

hermes setup --portal

Удачные варианты по умолчанию:

Большинству на первый раз хватит простого решения: выберите провайдера и оставьте значения по умолчанию, пока точно не знаете, зачем их менять. Полный каталог провайдеров моделей с переменными окружения и шагами настройки — на странице Провайдеры.

Как хранятся настройки

Hermes отделяет секреты от обычной конфигурации:

• Секреты и токены → ~/.hermes/.env
• Несекретные настройки → ~/.hermes/config.yaml

Проще всего задавать значения через CLI — так каждое попадёт по адресу:

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

Нужное значение само уходит в нужный файл.

3. Проведите первый чат

hermes            # классический CLI
hermes --tui      # современный TUI (рекомендуется)

Откроется приветственный баннер с вашей моделью, доступными инструментами и навыками. Возьмите конкретный запрос, результат которого легко проверить:

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

Check my current directory and tell me what looks like the main project file.

Help me set up a clean GitHub PR workflow for this codebase.

Как выглядит успех:

• Баннер показывает выбранную модель/провайдера
• Hermes отвечает без ошибок
• При необходимости агент вызывает инструмент (терминал, чтение файла, веб-поиск)
• Разговор нормально продолжается дольше одного хода

Сработало — самое сложное позади.

4. Убедитесь, что сессии работают

Прежде чем двигаться дальше, проверьте возобновление:

hermes --continue    # Вернуться к последней сессии
hermes -c            # Короткая форма

Команда должна вернуть вас в только что проведённую сессию. Если этого не произошло, проверьте, в том ли вы профиле и сохранилась ли сессия вообще. Мелочь, но она выручит позже, когда придётся жонглировать несколькими установками или машинами.

5. Попробуйте основные возможности

Работа с терминалом

❯ What's my disk usage? Show the top 5 largest directories.

Агент сам выполняет команды терминала и показывает результат.

Slash-команды

Наберите /, чтобы увидеть выпадающий список всех команд с автодополнением:

Многострочный ввод

Новую строку добавляют сочетанием Alt+Enter, Ctrl+J или Shift+Enter. Для Shift+Enter нужен терминал, отправляющий его отдельной последовательностью (по умолчанию Kitty / foot / WezTerm / Ghostty; iTerm2 / Alacritty / терминал VS Code — после включения клавиатурного протокола Kitty). Alt+Enter и Ctrl+J работают в любом терминале.

Прервать агента

Агент тянет слишком долго? Напишите новое сообщение и нажмите Enter — текущая задача прервётся, и он переключится на ваши свежие указания. Ctrl+C тоже сработает.

6. Добавляйте следующий слой

Только после того, как базовый чат заработал. Берите то, что нужно:

Бот или общий ассистент

hermes gateway setup    # Интерактивная настройка платформы

Подключите Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant или Microsoft Teams.

Автоматизация и инструменты

• hermes tools — настроить доступ к инструментам по платформам
• hermes skills — просмотреть и установить переиспользуемые сценарии
• Cron — только после того, как бот или CLI стабильны

Песочница-терминал

Ради безопасности запускайте агента в контейнере Docker или на удалённом сервере:

hermes config set terminal.backend docker    # Изоляция через Docker
hermes config set terminal.backend ssh       # Удалённый сервер

Голосовой режим

# Из каталога установки Hermes (curl-установщик кладёт его в
# ~/.hermes/hermes-agent на Linux/macOS или %LOCALAPPDATA%\hermes\hermes-agent на Windows):
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"
# Включает faster-whisper для бесплатного локального распознавания речи

Затем в CLI: /voice on. Нажмите Ctrl+B, чтобы записать. Смотрите Голосовой режим.

Навыки

Навыки — это инструкции по запросу, которые учат Hermes выполнять конкретную задачу: задеплоить в Kubernetes, открыть PR в GitHub, дообучить модель, найти GIF. Каждый навык — файл SKILL.md с именем, описанием и пошаговой процедурой. Короткие описания агент читает бесплатно, а полное содержимое навыка подгружает только тогда, когда задача этого действительно требует, — поэтому добавление навыков не раздувает каждый запрос.

В комплекте Hermes идёт каталог встроенных навыков, уже установленных в ~/.hermes/skills/. Можно добавить ещё из Skills Hub или написать свои.

Просмотр и установка из хаба:

hermes skills browse                      # показать всё доступное
hermes skills search kubernetes           # найти навыки по ключевому слову
hermes skills install openai/skills/k8s   # установить один (сначала сканирование безопасности)

Аргумент установки — это slug вида source/path из хаба: openai/skills/k8s означает навык k8s из каталога OpenAI. Точные slug-и показывает hermes skills browse.

Использование навыка — каждый установленный навык автоматически становится slash-командой:

/k8s deploy the staging manifest          # запустить навык с запросом
/k8s                                       # загрузить и дать Hermes спросить, что нужно

Работает и в CLI, и на любой подключённой платформе сообщений. Устанавливать всё заранее необязательно — в обычном разговоре агент сам подхватит подходящий встроенный навык, как только задача с ним совпадёт.

Как писать свои навыки, подключать внешние каталоги и где взять полный список источников хаба — в Системе навыков.

MCP-серверы

# Добавьте в ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Интеграция с редактором (ACP)

Поддержка ACP идёт со стандартным набором дополнений [all], так что curl-установщик уже включает её. Просто выполните:

hermes acp

(Если вы ставили без [all], сначала выполните cd ~/.hermes/hermes-agent && uv pip install -e ".[acp]".)

Смотрите Интеграция с редактором через ACP.

Типичные поломки

Эти проблемы съедают больше всего времени:

Аптечка восстановления

Когда что-то идёт не так, действуйте в таком порядке:

1. hermes doctor
2. hermes model
3. hermes setup
4. hermes sessions list
5. hermes --continue
6. hermes gateway status

Эта цепочка быстро возвращает из состояния «всё сломалось» в понятное рабочее.

Краткий справочник

Что дальше

• Руководство по CLI — освойте терминальный интерфейс
• Конфигурация — настройте всё под себя
• Шлюз сообщений — подключите Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Teams и другое
• Инструменты и наборы — изучите доступные возможности
• Провайдеры ИИ — полный список провайдеров и детали настройки
• Система навыков — переиспользуемые сценарии и знания
• Советы и практики — приёмы для продвинутых