Перейти к содержанию

Quickstart

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

Предпочитаете видео?​

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

Для кого это​

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

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

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

1. Установка Hermes Agent​

Запустите однострочный установщик: [code] # Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

[/code] Android / Termux Если вы устанавливаете на телефон, см. отдельное руководство по Termux с проверенным ручным путём, поддерживаемыми расширениями и текущими Android-ограничениями. Пользователи Windows Сначала установите WSL2, затем выполните команду выше внутри терминала WSL2. После завершения перезагрузите оболочку: [code] source ~/.bashrc # или source ~/.zshrc

[/code] Подробные варианты установки, требования и устранение неполадок — в Руководстве по установке.

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

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

[/code] Хорошие настройки по умолчанию: Провайдер| Что это| Как настроить
|---|---|---
Nous Portal| По подписке, без конфигурации| OAuth-логин через hermes model
OpenAI Codex| ChatGPT OAuth, использует модели Codex| Авторизация через код устройства через hermes model
Anthropic| Модели Claude напрямую — план Max + доп. кредиты (OAuth) или API-ключ для оплаты за токен| hermes model → OAuth-логин (требуется Max + доп. кредиты) или Anthropic API-ключ
OpenRouter| Маршрутизация между множеством моделей через одного провайдера| Введите ваш API-ключ
Z.AI| Модели GLM / Zhipu| Установите GLM_API_KEY / ZAI_API_KEY
Kimi / Moonshot| Модели Moonshot для кода и чата| Установите KIMI_API_KEY
Kimi / Moonshot China| Китайский регион 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| Китайский регион 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| Pay-as-you-go доступ к отобранным моделям| Установите 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 (запускает локальный copilot CLI)| hermes model (требуется copilot CLI + copilot login)
Vercel AI Gateway| Маршрутизация Vercel AI Gateway| Установите AI_GATEWAY_API_KEY
Кастомный endpoint| VLLM, SGLang, Ollama или любой OpenAI-совместимый API| Установите base URL + API-ключ
Для большинства новичков: выберите провайдера, примите настройки по умолчанию, если вы не знаете, зачем их менять. Полный каталог провайдеров с переменными окружения и шагами настройки — на странице Провайдеры. Минимальный контекст: 64K токенов Hermes Agent требует модель с контекстом как минимум 64 000 токенов. Модели с меньшим окном не могут поддерживать достаточную рабочую память для многошаговых рабочих процессов с вызовом инструментов и будут отклонены при запуске. Большинство хостинг-моделей (Claude, GPT, Gemini, Qwen, DeepSeek) легко соответствуют этому требованию. Если вы запускаете локальную модель, установите размер её контекста как минимум 64K (например, --ctx-size 65536 для llama.cpp или -c 65536 для Ollama). tip Вы можете сменить провайдера в любой момент с помощью hermes model — никакой привязки. Полный список всех поддерживаемых провайдеров и детали настройки — в разделе AI Провайдеры.

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

Hermes разделяет секреты и обычные настройки: * Секреты и токены → ~/.hermes/.env * Несекретные настройки → ~/.hermes/config.yaml

Самый простой способ правильно задать значения — через CLI: [code] hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

[/code] Нужное значение автоматически попадает в нужный файл.

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

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

[/code] Вы увидите приветственный баннер с вашей моделью, доступными инструментами и навыками. Используйте конкретный и легко проверяемый запрос: Выберите интерфейс Hermes поставляется с двумя терминальными интерфейсами: классическим CLI на prompt_toolkit и новым TUI с модальными окнами, выделением мышью и неблокирующим вводом. Оба используют одни и те же сессии, слэш-команды и конфигурацию — попробуйте каждый с hermes и hermes --tui. [code] Опиши этот репозиторий в 5 пунктах и скажи, что является главной точкой входа.

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

[/code] [code] Помоги мне настроить чистый GitHub PR workflow для этого кодовой базы.

[/code] Как выглядит успех: * Баннер показывает выбранную модель/провайдера * Hermes отвечает без ошибок * Он может использовать инструмент при необходимости (терминал, чтение файлов, веб-поиск) * Диалог продолжается нормально более одного оборота

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

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

Прежде чем двигаться дальше, убедитесь, что возобновление работает: [code] hermes --continue # Возобновить последнюю сессию
hermes -c # Краткая форма

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для безопасности запускайте агента в Docker-контейнере или на удалённом сервере: [code] hermes config set terminal.backend docker # Изоляция через Docker
hermes config set terminal.backend ssh # Удалённый сервер

[/code]

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

[code] pip install "hermes-agent[voice]"
# Включает faster-whisper для бесплатного локального распознавания речи

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

Навыки​

[code] hermes skills search kubernetes
hermes skills install openai/skills/k8s

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

MCP серверы​

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

[/code]

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

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

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

Частые проблемы​

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

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