🏠 Главная › Документация › Начало работы

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

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

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

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

Для кого это

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

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

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

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

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 Если вы устанавливаете на телефон, ознакомьтесь с отдельным руководством по Termux для проверенного ручного пути, поддерживаемых дополнений и текущих ограничений Android.

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

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

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

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

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

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

hermes model

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

Провайдер Описание Как настроить
Nous Portal По подписке, без конфигурации Вход через OAuth с помощью hermes model
OpenAI Codex OAuth ChatGPT, использует модели Codex Авторизация через код устройства с помощью hermes model
Anthropic Модели Claude напрямую — план Max + дополнительные кредиты (OAuth) или API-ключ для оплаты за токен hermes model → вход через OAuth (требуется Max + дополнительные кредиты) или API-ключ Anthropic
OpenRouter Маршрутизация между множеством провайдеров и моделей Введите ваш API-ключ
Z.AI Модели GLM / Zhipu Установите GLM_API_KEY / ZAI_API_KEY
Kimi / Moonshot Модели для кода и чата от Moonshot Установите KIMI_API_KEY (или KIMI_CODING_API_KEY для Kimi-Coding)
Kimi / Moonshot China Endpoint Moonshot для региона Китай Установите KIMI_CN_API_KEY
Arcee AI Модели Trinity Установите ARCEEAI_API_KEY
GMI Cloud Прямой API с множеством моделей Установите GMI_API_KEY
MiniMax (OAuth) MiniMax-M2.7 через браузерный OAuth — API-ключ не требуется hermes model → MiniMax (OAuth)
MiniMax Международный endpoint MiniMax Установите MINIMAX_API_KEY
MiniMax China Endpoint MiniMax для региона Китай Установите MINIMAX_CN_API_KEY
Alibaba Cloud Модели Qwen через DashScope Установите DASHSCOPE_API_KEY
Hugging Face 20+ открытых моделей через единый маршрутизатор (Qwen, DeepSeek, Kimi и др.) Установите HF_TOKEN
AWS Bedrock Claude, Nova, Llama, DeepSeek через нативный Converse API IAM-роль или aws configure (гайд)
Kilo Code Модели от KiloCode Установите KILOCODE_API_KEY
OpenCode Zen Оплата по мере использования для отобранных моделей Установите OPENCODE_ZEN_API_KEY
OpenCode Go Подписка $10/месяц для открытых моделей Установите OPENCODE_GO_API_KEY
DeepSeek Прямой доступ к API DeepSeek Установите 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 (запускает локальный CLI copilot) hermes model (требуется CLI copilot + copilot login)
Vercel AI Gateway Маршрутизация Vercel AI Gateway Установите AI_GATEWAY_API_KEY
Пользовательский endpoint VLLM, SGLang, Ollama или любое API, совместимое с OpenAI Установите базовый URL + API-ключ

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

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

Вы можете сменить провайдера в любое время с помощью `hermes model` — никакой привязки. Полный список всех поддерживаемых провайдеров и детали настройки см. в разделе [AI Провайдеры](../integrations/providers.md).

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

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

Самый простой способ правильно задать значения — через 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 (рекомендуется)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Нажмите 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.

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

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

Для безопасности запускайте агента в 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 для записи. Подробнее: Голосовой режим.

Навыки (Skills)

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.

Частые сценарии отказов

Вот проблемы, которые отнимают больше всего времени:

Симптом Вероятная причина Исправление
Hermes открывается, но выдает пустые или некорректные ответы Неверная аутентификация провайдера или выбор модели Запустите hermes model снова и подтвердите провайдера, модель и аутентификацию
Пользовательский endpoint «работает», но возвращает мусор Неверный базовый URL, название модели или несовместимость с OpenAI Сначала проверьте endpoint в отдельном клиенте
Gateway запускается, но никто не может написать ему Токен бота, список разрешений или настройка платформы неполны Повторно запустите hermes gateway setup и проверьте hermes gateway status
hermes --continue не находит старую сессию Смена профиля или сессия не сохранилась Проверьте hermes sessions list и убедитесь, что вы в правильном профиле
Модель недоступна или странное резервное поведение Маршрутизация или настройки резервирования слишком агрессивны Отключите маршрутизацию, пока базовый провайдер не станет стабильным
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 gateway Запуск шлюза сообщений
hermes --continue Возобновление последней сессии

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