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

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

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

Onchain AI Garage подготовили мастер-класс по установке, настройке и базовым командам. Это хорошее дополнение к этой странице, если вам удобнее идти по видео. Подробнее см. плейлист Hermes Agent Tutorials & Use Cases.

Встроенный iframe был удален при импорте из соображений безопасности. Исходный источник: https://www.youtube-nocookie.com/embed/R3YOGfTBcQg

Для кого это

• Вы только начинаете и хотите самый короткий путь к рабочей настройке
• Вы меняете провайдера и не хотите терять время на ошибки конфигурации
• Вы настраиваете Hermes для команды, бота или постоянно работающего сценария
• Вам надоело состояние “установилось, но все равно ничего не делает”

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

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

Цель	Сначала сделайте это	Затем сделайте это
Мне нужно просто запустить Hermes на своем компьютере	hermes setup	Запустите реальный чат и убедитесь, что Hermes отвечает
Я уже знаю своего провайдера	hermes model	Сохраните конфигурацию и начните общение
Мне нужен бот или постоянно работающая настройка	hermes gateway setup после того, как заработает CLI	Подключите Telegram, Discord, Slack или другую платформу
Мне нужна локальная или self-hosted модель	hermes model → custom endpoint	Проверьте endpoint, имя модели и длину контекста
Мне нужен fallback между несколькими провайдерами	Сначала hermes model	Добавляйте routing и fallback только после того, как базовый чат уже работает

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

---

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

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

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

:::tip Android / Termux Если вы устанавливаете Hermes на телефон, см. отдельное руководство по Termux с проверенным ручным способом, поддерживаемыми дополнительными компонентами и актуальными ограничениями для Android. :::

:::tip Windows Users Сначала установите WSL2, затем выполните команду выше внутри терминала WSL2. :::

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

source ~/.bashrc   # or source ~/.zshrc

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

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

Это самый важный шаг настройки. Используйте hermes model, чтобы интерактивно пройти выбор:

hermes model

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

Провайдер	Что это	Как настроить
Nous Portal	Подписочный сервис без сложной настройки	Войти через OAuth в hermes model
OpenAI Codex	OAuth через ChatGPT, использует модели Codex	Аутентификация по device code через hermes model
Anthropic	Модели Claude напрямую: план Max + дополнительные usage credits через OAuth либо API key с оплатой по токенам	hermes model → вход через OAuth (нужны Max + extra credits) либо ключ Anthropic API
OpenRouter	Маршрутизация между многими провайдерами и моделями	Введите свой API key
Z.AI	Модели GLM, размещенные у Zhipu	Укажите GLM_API_KEY / ZAI_API_KEY
Kimi / Moonshot	Модели для кодинга и чата, размещенные у Moonshot	Укажите KIMI_API_KEY (или специальный KIMI_CODING_API_KEY)
Kimi / Moonshot China	Moonshot endpoint для региона China	Укажите KIMI_CN_API_KEY
Arcee AI	Модели Trinity	Укажите ARCEEAI_API_KEY
GMI Cloud	Прямой multi-model API	Укажите GMI_API_KEY
MiniMax (OAuth)	MiniMax-M2.7 через browser OAuth, без API key	hermes model → MiniMax (OAuth)
MiniMax	Международный endpoint MiniMax	Укажите MINIMAX_API_KEY
MiniMax China	MiniMax endpoint для региона China	Укажите MINIMAX_CN_API_KEY
Alibaba Cloud	Модели Qwen через DashScope	Укажите DASHSCOPE_API_KEY
Hugging Face	20+ открытых моделей через единый router (Qwen, DeepSeek, Kimi и др.)	Укажите HF_TOKEN
AWS Bedrock	Claude, Nova, Llama и DeepSeek через native Converse API	IAM role или aws configure (guide)
Kilo Code	Модели, размещенные у KiloCode	Укажите KILOCODE_API_KEY
OpenCode Zen	Pay-as-you-go доступ к отобранным моделям	Укажите OPENCODE_ZEN_API_KEY
OpenCode Go	Подписка $10/month для open models	Укажите OPENCODE_GO_API_KEY
DeepSeek	Прямой доступ к DeepSeek API	Укажите DEEPSEEK_API_KEY
NVIDIA NIM	Модели Nemotron через build.nvidia.com или локальный NIM	Укажите NVIDIA_API_KEY (необязательно: NVIDIA_BASE_URL)
GitHub Copilot	Подписка GitHub Copilot (GPT-5.x, Claude, Gemini и др.)	OAuth через hermes model либо COPILOT_GITHUB_TOKEN / GH_TOKEN
GitHub Copilot ACP	Copilot ACP agent backend, который запускает локальный copilot CLI	hermes model (нужны copilot CLI и copilot login)
Vercel AI Gateway	Маршрутизация через Vercel AI Gateway	Укажите AI_GATEWAY_API_KEY
Custom Endpoint	VLLM, SGLang, Ollama или любой API, совместимый с OpenAI	Укажите base URL и API key

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

:::caution Минимальный контекст: 64K токенов Hermes Agent требует модель с контекстом не менее 64 000 токенов. Модели с меньшим окном контекста не могут удерживать достаточно рабочей памяти для многошаговых рабочих процессов с вызовом инструментов и будут отклонены при запуске. Большинство hosted-моделей (Claude, GPT, Gemini, Qwen, DeepSeek) легко проходят это требование. Если вы запускаете локальную модель, задайте ей контекст не менее 64K, например --ctx-size 65536 для llama.cpp или -c 65536 для Ollama. :::

Совет

Вы можете в любой момент сменить провайдера через 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-...

CLI сам положит каждое значение в правильный файл.

3. Запустите первый чат

hermes            # classic CLI
hermes --tui      # modern TUI (recommended)

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

:::tip Выберите интерфейс Hermes поставляется с двумя терминальными интерфейсами: классическим prompt_toolkit CLI и более новым TUI с модальными оверлеями, выделением мышью и неблокирующим вводом. Оба используют одни и те же сессии, slash-команды и конфигурацию. Попробуйте оба режима: hermes и hermes --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 отвечает без ошибки
• При необходимости он умеет использовать инструмент: терминал, чтение файлов, web search
• Диалог продолжается нормально более одного хода

Если это работает, значит самый сложный этап уже позади.

4. Проверьте, что сессии работают

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

hermes --continue    # Resume the most recent session
hermes -c            # Short form

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

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

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

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

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

Slash-команды

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

Команда	Что делает
/help	Показать все доступные команды
/tools	Показать список доступных инструментов
/model	Интерактивно переключить модель
/personality pirate	Включить забавную персоналию
/save	Сохранить диалог

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

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

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

Если агент отвечает слишком долго, введите новое сообщение и нажмите Enter. Это прервет текущую задачу и переключит Hermes на новые инструкции. Ctrl+C тоже работает.

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

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

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

hermes gateway setup    # Interactive platform configuration

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

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

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

Изолированный терминал

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

hermes config set terminal.backend docker    # Docker isolation
hermes config set terminal.backend ssh       # Remote server

Voice mode

# From the Hermes install directory (the curl installer placed it at
# ~/.hermes/hermes-agent on Linux/macOS or %LOCALAPPDATA%\hermes\hermes-agent on Windows):
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"
# Includes faster-whisper for free local speech-to-text

Затем в CLI выполните /voice on. Для записи нажмите Ctrl+B. Подробнее см. Voice Mode.

Навыки

hermes skills search kubernetes
hermes skills install openai/skills/k8s

Или используйте /skills прямо внутри чат-сессии.

MCP servers

# Add to ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

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

Поддержка ACP уже входит в стандартный набор extras [all], поэтому curl-установщик ставит ее сразу. Достаточно выполнить:

hermes acp

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

См. ACP Editor Integration.

---

Распространенные проблемы

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

Симптом	Вероятная причина	Что делать
Hermes запускается, но отвечает пусто или сломанно	Неверная аутентификация провайдера или неправильный выбор модели	Снова выполните hermes model и проверьте провайдера, модель и авторизацию
Custom endpoint “работает”, но возвращает мусор	Неверный base URL, имя модели или endpoint на самом деле не совместим с OpenAI	Сначала проверьте endpoint через отдельный клиент
Gateway запустился, но никто не может писать боту	Не завершена настройка bot token, allowlist или самой платформы	Повторно выполните hermes gateway setup и проверьте hermes gateway status
hermes --continue не находит старую сессию	Вы сменили профиль или сессия вообще не сохранилась	Проверьте hermes sessions list и убедитесь, что вы в правильном профиле
Модель недоступна или fallback ведет себя странно	Слишком агрессивно настроены routing или fallback	Держите routing выключенным, пока базовый провайдер не станет стабильным
hermes doctor показывает проблемы конфигурации	Значения конфигурации отсутствуют или устарели	Исправьте конфигурацию и снова проверьте обычный чат до добавления новых функций

Набор для восстановления

Если что-то ведет себя странно, идите в таком порядке:

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

Эта последовательность быстро возвращает вас из состояния “что-то не так” в понятное рабочее состояние.

---

Краткая справка

Команда	Описание
hermes	Начать чат
hermes model	Выбрать LLM-провайдера и модель
hermes tools	Настроить, какие инструменты включены для каждой платформы
hermes setup	Полный мастер настройки
hermes doctor	Диагностика проблем
hermes update	Обновить Hermes до последней версии
hermes gateway	Запустить messaging gateway
hermes --continue	Возобновить последнюю сессию

Что читать дальше

• CLI Guide — разобраться в терминальном интерфейсе
• Configuration — настроить Hermes под себя
• Messaging Gateway — подключить Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Teams и другие платформы
• Tools & Toolsets — посмотреть доступные возможности
• AI Providers — полный список провайдеров и детали настройки
• Skills System — переиспользуемые сценарии и знания
• Tips & Best Practices — советы для продвинутого использования