FAQ

· 5 мин чтения · admin

Частые вопросы

Какие LLM-провайдеры поддерживаются?

Hermes Agent работает с любым OpenAI-совместимым API: OpenRouter, OpenAI, Anthropic, Google Gemini, Ollama, vLLM и другие локальные решения.

Работает ли на Windows?

Да, через WSL2. Установите WSL2 с Ubuntu, затем выполните стандартную установку. Также работает на Android через Termux.

Отправляются ли мои данные куда-либо?

Все данные хранятся локально в ~/.hermes/. Данные отправляются только выбранному LLM-провайдеру. Телеметрия не собирается.

Сколько это стоит?

Hermes — бесплатное ПО (лицензия MIT). Оплачиваются только запросы к LLM-провайдеру.

В чём разница между памятью и навыками?

  • Память (Memory) — факты и предпочтения из разговоров
  • Навыки (Skills) — инструкции и инструменты, расширяющие возможности

Решение проблем

Ошибка 400 при первом запуске

Проверьте конфигурацию: hermes config show. Убедитесь, что модель доступна по вашему API-ключу. Попробуйте hermes model для перенастройки.

Permission denied после установки

Выполните chmod 644 ~/.zshrc, затем source ~/.zshrc. Или откройте новое окно терминала.

Проблемы с подключением к провайдеру

  • Проверьте действительность API-ключа
  • Для OpenRouter убедитесь в наличии кредитов
  • Проверьте точность имени модели

DeepSeek V4 reasoning не работает (native API)

Симптом: deepseek-v4-pro или deepseek-v4-flash отвечает быстро, без видимого рассуждения (thinking), даже если reasoning_effort установлен в конфиге.

Причина: Hermes НЕ отправляет thinking: {type: enabled} в запросе для нативного DeepSeek провайдера. Модели DeepSeek V4 требуют это поле в extra_body для активации режима мышления.

Решение: Используйте OpenRouter вместо нативного DeepSeek API — OpenRouter прокидывает reasoning extra_body к DeepSeek. Или пропатчите исходный код Hermes для поддержки DeepSeek thinking.

Vision routing — как работает auto provider

По умолчанию auxiliary.vision.provider: "auto" маршрутизирует запросы к вашей основной модели (та же модель и провайдер, что указаны в model.default). Это НЕ OpenRouter.

  • Если основная модель поддерживает vision (GPT-4V, Claude, Gemini, MiMo-VL и т.д.) — изображение отправляется как пиксели напрямую
  • Если основная модель текстовая — изображение обрабатывается через vision_analyze auxiliary tool

Для принудительного использования конкретного бэкенда:

hermes config set auxiliary.vision.provider openrouter
hermes config set auxiliary.vision.model google/gemini-2.5-flash

Credential pools — как ротировать ключи

Hermes поддерживает пулы учётных данных для автоматической ротации API-ключей:

hermes auth add             # Интерактивное добавление ключа
hermes auth list [PROVIDER] # Список ключей провайдера
hermes auth remove P INDEX  # Удалить по провайдеру + индекс
hermes auth reset PROVIDER  # Сбросить статус исчерпанности

При ошибке rate-limit Hermes автоматически переключается на следующий доступный ключ в пуле.

Approvals mode — smart/manual/off

Режимы одобрения команд перед выполнением:

  • manual — всегда спрашивать (по умолчанию)
  • smart — LLM автоматически одобряет безопасные команды, спрашивает о рискованных
  • off — пропускать все одобрения (эквивалент --yolo)
hermes config set approvals.mode smart
hermes config set approvals.mode off

Разовый обход: hermes --yolo ... или export HERMES_YOLO_MODE=1

Secret redaction — скрытие секретов в выводе

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

hermes config set security.redact_secrets true

Требуется перезапуск. Настройка считывается при старте сессии — изменение mid-session не применяется. Это сделано намеренно, чтобы LLM не мог отключить фильтр сам.

PII redaction — скрытие персональных данных

Отдельно от secret redaction. Когда включено, gateway хеширует ID пользователей и удаляет номера телефонов из контекста сессии:

hermes config set privacy.redact_pii true    # включить
hermes config set privacy.redact_pii false   # выключить (по умолчанию)

Telegram Business API не поддерживается

Функция «Chat Automation» от Telegram (май 2026) требует обработки business_connection_id в telegram-адаптере. На данный момент Hermes не поддерживает эту функцию — business_connection_id не используется в gateway/platforms/telegram.py. Ответы отправляются как сообщения бота, а не пользователя.

Copilot 403 — нужен OAuth device code flow

Симптом: ошибка 403 при использовании GitHub Copilot.

Причина: токены gh auth login НЕ работают для Copilot API. Нужен специальный OAuth device code flow.

Решение: используйте hermes model → GitHub Copilot для авторизации через device code flow.

Gateway умирает при SSH logout

Причина: systemd user service останавливается при закрытии SSH-сессии.

Решение: включите linger:

sudo loginctl enable-linger $USER

Это позволяет user-сервисам работать независимо от сессии пользователя.

WSL2 gateway — нужен systemd=true

Симптом: gateway не работает как сервис в WSL2, падает при закрытии терминала.

Причина: WSL2 не запускает systemd по умолчанию. Без него gateway работает через nohup и умирает при закрытии сессии.

Решение: добавьте в /etc/wsl.conf:

[boot]
systemd=true

Затем перезапустите WSL: wsl --shutdown и запустите заново.

Cron: send_message не работает

Симптом: cron job не может отправить сообщение через send_message — инструмент не найден или ImportError.

Причина: send_message принадлежит тулсету messaging, который НЕ включён в toolsets cron-сессий по умолчанию.

Решение: добавьте messaging в enabled_toolsets cron job:

cronjob(action="update", job_id="...", enabled_toolsets=["terminal", "file", "browser", "web", "messaging"])

Важно: когда enabled_toolsets задан, он переопределяет все дефолты — укажите все нужные тулсеты, не только messaging.

Профили и бэкап

Перенос на другой компьютер

hermes backup создаст zip-архив. Скопируйте на новую машину и выполните hermes import ~/hermes-backup.zip.

hermes backup vs hermes profile export

  • hermes backup — полный бэкап ~/.hermes/ с ключами
  • hermes profile export — один профиль без учётных данных

Нужна помощь?

Поиск решений — GitHub Issues. Вопросы сообществу — Nous Research Discord. При баг-репорте укажите ОС, версию Python и Hermes.