Hermes Agent ☤

Hermes Agent | Hermes Desktop

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

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

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

Linux, macOS, WSL2, Termux

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

Внимание: Hermes работает на Windows в нативном режиме без 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 для выполнения команд оболочки.

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

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

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

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

source ~/.bashrc    # reload shell (or: source ~/.zshrc)
hermes              # start chatting!

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

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

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

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

# Install GitHub CLI if needed
winget install --id GitHub.cli

# Login to GitHub
gh auth login

# Run verification
$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 (Защита > Антивирус > Настройки > Управление исключениями) - Добавьте в белый список папку, а не хеш файла — Hermes обновляет uv, и хеш меняется с каждой версией

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

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

hermes              # Interactive CLI — start a conversation
hermes model        # Choose your LLM provider and model
hermes tools        # Configure which tools are enabled
hermes config set   # Set individual config values
hermes config get   # Print individual config values
hermes gateway      # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup        # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update       # Update to the latest version
hermes doctor       # Diagnose any issues

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

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

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

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

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

hermes setup --portal

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

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

Краткий справочник: CLI vs Мессенджеры

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

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

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

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

Миграция с OpenClaw

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

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

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

hermes claw migrate              # Interactive migration (full preset)
hermes claw migrate --dry-run    # Preview what would be migrated
hermes claw migrate --preset user-data   # Migrate without secrets
hermes claw migrate --overwrite  # Overwrite existing conflicts

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

• 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
• 📚 Хаб навыков
• 🐛 Баг-трекер
• 🔌 computer-use-linux — MCP-сервер для управления Linux-десктопом для Hermes и других MCP-хостов с деревьями доступности AT-SPI, вводом Wayland/X11, скриншотами и нацеливанием на окна композитора.
• 🔌 HermesClaw — Комьюнити-мост для WeChat: Запускайте Hermes Agent и OpenClaw на одном аккаунте WeChat.

Лицензия

MIT — см. LICENSE.

Разработано Nous Research.