Hermes Agent ☤

Hermes Agent | Hermes Desktop

Самосовершенствующийся ИИ-агент, созданный Nous Research. Это единственный агент со встроенным циклом обучения — он создаёт навыки из опыта, улучшает их в процессе использования, подталкивает себя к сохранению знаний, ищет в своих прошлых разговорах и строит углубляющуюся модель того, кто вы, между сеансами. Запускайте его на VPS за $5, GPU-кластере или serverless-инфраструктуре, которая почти ничего не стоит в простое. Он не привязан к вашему ноутбуку — общайтесь с ним из Telegram, пока он работает на облачной VM.

Используйте любую модель — Nous Portal, OpenRouter, OpenAI, собственный endpoint и многие другие. Переключайтесь с помощью hermes model — без изменения кода, без привязки к вендору.

Быстрая установка

Linux, macOS, WSL2, Termux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (нативно, PowerShell)

Внимание: Нативная Windows запускает Hermes без WSL — CLI, шлюз, TUI и инструменты работают нативно. Если вы предпочитаете WSL2, однострочная команда для Linux/macOS выше тоже работает там. Нашли ошибку? Пожалуйста, сообщите о проблеме.

Выполните в PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Установщик обрабатывает всё: uv, Python 3.11, Node.js, ripgrep, ffmpeg, и портативный Git Bash (MinGit, распакованный в %LOCALAPPDATA%\hermes\git — не требует прав администратора, полностью изолирован от любой системной установки Git). Hermes использует этот встроенный Git Bash для выполнения shell-команд.

Если у вас уже установлен Git, установщик обнаружит его и будет использовать его. В противном случае достаточно загрузки MinGit (~45MB) — она не затронет и не помешает системному Git.

Android / Termux: Проверенный ручной путь описан в руководстве по Termux. На Termux Hermes устанавливает специальный дополнительный пакет .[termux], потому что полный .[all] в настоящее время тянет несовместимые с Android голосовые зависимости.

Windows: Нативная Windows полностью поддерживается — однострочная команда PowerShell выше устанавливает всё. Если вы предпочитаете WSL2, команда Linux работает и там. Нативная установка Windows находится в %LOCALAPPDATA%\hermes; установка WSL2 — в ~/.hermes, как на Linux.

После установки:

source ~/.bashrc    # перезагрузите оболочку (или: source ~/.zshrc)
hermes              # начните общение!

Устранение неполадок

Windows Defender или антивирус помечает uv.exe как вредоносное ПО

Если ваш антивирус (Bitdefender, Windows Defender и т. д.) помещает в карантин uv.exe из папки bin Hermes (%LOCALAPPDATA%\hermes\bin\uv.exe), это ложное срабатывание. Файл — это uv от Astral — менеджер пакетов Python на Rust, который Hermes включает для управления своей средой Python. ML-антивирусные движки часто помечают неподписанные Rust-бинарники, которые скачивают и устанавливают пакеты.

Чтобы проверить подлинность вашей копии:

# Установите GitHub CLI, если нужно
winget install --id GitHub.cli

# Войдите в GitHub
gh auth login

# Запустите проверку
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

Если аттестация говорит «Verification succeeded», а последняя строка выводит True, всё в порядке.

Чтобы добавить Hermes в белый список:

• Windows Defender: Запустите PowerShell от имени администратора → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Добавьте исключение в консоли Bitdefender (Protection > Antivirus > Settings > Manage Exceptions)
• Добавьте в белый список папку, а не хэш файла — Hermes обновляет uv, и хэш меняется с каждой версией

Для дополнительного контекста см. отчёты Astral выше по цепочке: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.

Начало работы

hermes              # Интерактивный CLI — начните разговор
hermes model        # Выберите провайдера LLM и модель
hermes tools        # Настройте, какие инструменты включены
hermes config set   # Установите отдельные значения конфигурации
hermes config get   # Выведите отдельные значения конфигурации
hermes gateway      # Запустите шлюз обмена сообщениями (Telegram, Discord и т. д.)
hermes setup        # Запустите полный мастер настройки (настраивает всё сразу)
hermes claw migrate # Миграция из OpenClaw (если переходите с OpenClaw)
hermes update       # Обновление до последней версии
hermes doctor       # Диагностика любых проблем

📖 Полная документация →

Без сбора API-ключей — Nous Portal

Hermes работает с любым провайдером, который вы хотите — это не меняется. Но если вы не хотите собирать пять отдельных API-ключей для модели, веб-поиска, генерации изображений, TTS и облачного браузера, Nous Portal покрывает всё это одной подпиской:

• 300+ моделей — выбирайте любую с помощью /model <name>
• Tool Gateway — веб-поиск (Firecrawl), генерация изображений (FAL), текст-в-речь (OpenAI), облачный браузер (Browser Use) — всё маршрутизируется через вашу подписку. Без дополнительных аккаунтов.

Одна команда после чистой установки:

hermes setup --portal

Это войдёт через OAuth, установит Nous как провайдера и включит Tool Gateway. Проверяйте, что подключено, в любой момент с помощью hermes portal info. Подробности на странице документации Tool Gateway.

Вы по-прежнему можете приносить свои ключи для каждого инструмента, когда захотите — шлюз работает по бэкендам, а не по принципу «всё или ничего».

CLI и мессенджеры: краткая справка

У Hermes две точки входа: запустите терминальный интерфейс с помощью hermes или запустите шлюз и общайтесь с ним из Telegram, Discord, Slack, WhatsApp, Signal или Email. В разговоре многие слэш-команды общие для обоих интерфейсов.

Полные списки команд см. в руководстве по CLI и руководстве по шлюзу обмена сообщениями.

Документация

Вся документация находится на hermes-agent.nousresearch.com/docs:

Миграция с OpenClaw

Если вы переходите с OpenClaw, Hermes может автоматически импортировать ваши настройки, воспоминания, навыки и API-ключи.

Во время первой настройки: Мастер настройки (hermes setup) автоматически обнаруживает ~/.openclaw и предлагает миграцию до начала конфигурации.

В любое время после установки:

hermes claw migrate              # Интерактивная миграция (полный пресет)
hermes claw migrate --dry-run    # Предпросмотр того, что будет перенесено
hermes claw migrate --preset user-data   # Миграция без секретов
hermes claw migrate --overwrite  # Перезапись существующих конфликтов

Что импортируется:

• SOUL.md — файл личности
• Воспоминания — записи MEMORY.md и USER.md
• Навыки — созданные пользователем навыки → ~/.hermes/skills/openclaw-imports/
• Список разрешённых команд — шаблоны одобрения
• Настройки обмена сообщениями — конфигурации платформ, разрешённые пользователи, рабочая директория
• API-ключи — разрешённые секреты (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• TTS-ресурсы — аудиофайлы рабочей области
• Инструкции рабочей области — AGENTS.md (с --workspace-target)

См. hermes claw migrate --help для всех параметров или используйте навык openclaw-migration для интерактивной миграции под руководством агента с предпросмотром dry-run.

Участие в разработке

Мы приветствуем вклад! См. Руководство по участию для настройки разработки, стиля кода и процесса PR.

Быстрый старт для контрибьюторов — используйте стандартный установщик, затем работайте из полного git-чекаута, который он создаёт в $HERMES_HOME/hermes-agent (обычно ~/.hermes/hermes-agent). Это соответствует структуре, используемой hermes update, управляемым venv, ленивыми зависимостями, шлюзом и инструментами документации.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Ручное клонирование (для одноразовых клонов/CI, где вы намеренно не хотите управляемую структуру установки):

Создайте venv вне дерева исходников — venv внутри директории, из которой работает агент, может быть стёрт командой с относительным путём, которую агент выполняет против собственного чекаута, уничтожая работающий рантайм посреди сеанса.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Сообщество

• 💬 Discord
• 📚 Skills Hub
• 🐛 Проблемы
• 🔌 computer-use-linux — MCP-сервер управления Linux-десктопом для Hermes и других MCP-хостов, с AT-SPI деревьями доступности, вводом Wayland/X11, скриншотами и нацеливанием на окна композитора.
• 🔌 HermesClaw — Мост сообщества для WeChat: запускайте Hermes Agent и OpenClaw на одном аккаунте WeChat.

Лицензия

MIT — см. LICENSE.

Создано Nous Research.