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

Это руководство приведет вас от нуля до рабочей установки Hermes, которая выдерживает реальное использование. Выберите, выберите провайдера, проверьте работающий чат и точно знайте, что делать, если что-то сломается.

Предпочитаете посмотреть?

Onchain AI Garage подготовка мастер-класса по установке, настройке и основной команде — хорошее дополнение к этой странице, если вы предпочитаете приветствовать видео. Больше на полном плейлисте [Руководства и примеры использования Hermes Agent] (https://www.youtube.com/channel/UCqB1bhMwGsW-yefBxYwFCCg).

Для кого это

• Совершенно новый пользователь, который хочет кратчайший путь к рабочей установке.
• Меняете провайдера и не хотите терять время на неправильную настройку.
• Настраиваете Hermes для команды, бота или постоянно работающего процесса
• Устали от «установилось, но всё равно ничего не работает»

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

Выберите текст, соответствующий вашим целям:

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

1. Настройка агента Гермеса

Запустите однострочный установщик:

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```:::подсказка Android/Termux
Если вы установите на телефон, см. специальное [руководство по Termux](./termux.md) для проверенного ручного пути, применяемых экстра и действующих ограничений, специфичных для Android.::::::совет Пользователи Windows
Сначала установите [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install), затем выполните команду внутри вашего терминала WSL2.</div>
После завершения перезагрузите оболочку:
```bash
source ~/.bashrc   # или source ~/.zshrc

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

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

Самый важный шаг настройки. Используйте «модель Гермеса», чтобы выполнить выбор в интерактивном режиме:

hermes model

Хорошие значения по умолчанию:

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

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

Раздел 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 (рекомендуется)

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

Обобщи этот репозиторий в 5 пунктов и скажи, что является основной точкой входа.

Проверь мою текущую директорию и скажи, какой файл выглядит как главный файл проекта.

Помоги мне настроить чистый рабочий процесс GitHub PR для этой кодовой базы.

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

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

Если это работает, то вы прошли самую сложную часть.

4. Проверить работу сессий

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

hermes --continue    # Возобновить последнюю сессию
hermes -c            # Краткая форма

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

5. Откройте ключевую функцию

Используйте терминал

❯ Сколько у меня занято места на диске? Покажи 5 самых больших директорий.

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

Слеш-команды

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

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

Нажмите «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, Электронная почта, Home Assistant или Microsoft Teams.

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

• hermestools — настройка доступа к инструментам для каждой платформы.
• гермесовые навыки — просмотр и установка переиспользуемых рабочих процессов.
• 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 skills search kubernetes
hermes skills install openai/skills/k8s

Или викорируйте /skills внутри чат-сессии.

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. доктор Гермес
2. модель Гермеса
3. настройка Гермеса
4. список сеансов Гермеса
5. Гермес --продолжить
6. «Состояние шлюза Гермеса»

Этот момент быстро вернет вас от «сломанных ощущений» к известному состоянию.

Быстрая справка

Следующие шаги

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