🏠 Главная › Getting Started › quickstart

sidebar_position: 1 title: "Quickstart" description: "Your first conversation with Hermes Agent — from install to chatting in under 5 minutes" lang: ru

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

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

Для кого это

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

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

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

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

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

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

# 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, затем выполните указанную выше команду внутри терминала WSL2. После завершения перезагрузите оболочку:

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

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

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

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

hermes model

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

Провайдер Что это такое Как настроить
Портал Ноус На основе подписки, без настройки Вход по OAuth через hermes model
Кодекс OpenAI ChatGPT OAuth использует модели Кодекса Аутентификация кода устройства через hermes model
Антропный Непосредственное моделирование Клода — максимальный план + дополнительные кредиты на использование (OAuth) или ключ API для оплаты за токен hermes model → Вход по OAuth (требуется Макс. + дополнительные кредиты) или ключ API Anthropic
OpenRouter Маршрутизация между несколькими провайдерами во многих моделях Введите свой ключ API
З.АИ Модели на базе GLM/Zhipu Установить GLM_API_KEY / ZAI_API_KEY
Кими / Муншот Модели программирования и чата, размещенные на Moonshot Установить KIMI_API_KEY
Кими / Moonshot China Конечная точка Moonshot в регионе Китая Установить KIMI_CN_API_KEY
Арси ИИ Модели троицы Установить ARCEEAI_API_KEY
Облако GMI Многомодельный прямой API Установить GMI_API_KEY
МиниМакс (OAuth) MiniMax-M2.7 через браузер OAuth — ключ API не требуется hermes model → МиниМакс (OAuth)
МиниМакс Международная конечная точка MiniMax Установить MINIMAX_API_KEY
МиниМакс Китай Конечная точка MiniMax в регионе Китая Установить MINIMAX_CN_API_KEY
Облако Алибаба Модели Qwen через DashScope Установить DASHSCOPE_API_KEY
Обнимающее лицо 20+ открытых моделей через единый роутер (Qwen, DeepSeek, Kimi и др.) Установить HF_TOKEN
Код килограмма Модели, размещенные на KiloCode Установить KILOCODE_API_KEY
OpenCode Дзен Доступ к курируемым моделям с оплатой по мере использования Установите OPENCODE_ZEN_API_KEY
OpenCode Go Подписка на открытые модели стоимостью 10 долларов США в месяц Установить OPENCODE_GO_API_KEY
Глубокий поиск Прямой доступ к API DeepSeek Установить DEEPSEEK_API_KEY
НВИДИЯ НИМ Модели Nemotron через build.nvidia.com или локальный NIM Установите NVIDIA_API_KEY (необязательно: NVIDIA_BASE_URL)
Второй пилот GitHub Подписка на GitHub Copilot (GPT-5.x, Claude, Gemini и т. д.) OAuth через hermes model или COPILOT_GITHUB_TOKEN / GH_TOKEN
GitHub Copilot ACP Серверная часть агента Copilot ACP (создает локальный интерфейс командной строки copilot) hermes model (требуется copilot CLI + copilot login)
Шлюз Vercel AI Маршрутизация Vercel AI Gateway Установить AI_GATEWAY_API_KEY
Пользовательская конечная точка VLLM, SGLang, Ollama или любой API, совместимый с OpenAI Установить базовый URL + ключ API

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

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

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

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

Самый простой способ правильно установить значения — через 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            # classic CLI
hermes --tui      # modern TUI (recommended)

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

💡 Tip

Выберите свой интерфейс Hermes поставляется с двумя интерфейсами терминала: классическим CLI `prompt_toolkit` и новым [TUI](../user-guide/tui.md) с модальными наложениями, выбором с помощью мыши и неблокирующим вводом. Оба используют одни и те же сеансы, команды слэша и конфигурацию — попробуйте каждый с `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    # Resume the most recent session
hermes -c            # Short form

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

5. Попробуйте ключевые функции

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

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

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

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

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

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

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

Нажмите Alt+Enter или Ctrl+J, чтобы добавить новую строку. Отлично подходит для вставки кода или написания подробных подсказок.

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

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

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

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

Бот или общий помощник

hermes gateway setup    # Interactive platform configuration

Подключите Telegram, Discord, Slack, WhatsApp, Signal, Электронная почта или Home Assistant.

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

Терминал в песочнице

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

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

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

pip install "hermes-agent[voice]"
# Includes faster-whisper for free local speech-to-text

Затем в CLI: /voice on. Нажмите Ctrl+B для записи. См. Голосовой режим.

Навыки

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

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

MCP-серверы

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

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

pip install -e '.[acp]'
hermes acp

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

Распространенные режимы отказа

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

Симптом Вероятная причина Исправить
Гермес открывается, но дает пустые или неработающие ответы Неправильный выбор аутентификации провайдера или модели Запустите hermes model еще раз и подтвердите поставщика, модель и аутентификацию
Пользовательская конечная точка «работает», но возвращает мусор Неверный базовый URL-адрес, название модели или несовместимость с OpenAI Сначала проверьте конечную точку в отдельном клиенте
Шлюз запускается, но никто не может отправить ему сообщение Настройка токена бота, белого списка или платформы не завершена Перезапустите 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 Возобновить последнюю сессию

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