nousresearch/hermes-agentАгент, который растет вместе с вами
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Документация"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="Лицензия: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Создано Nous Research"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**Самоулучшающийся ИИ-агент, созданный [Nous Research](https://nousresearch.com).** Это единственный агент со встроенным циклом обучения — он создаёт навыки из опыта, улучшает их в процессе использования, подталкивает себя к сохранению знаний, ищет в своих прошлых разговорах и строит углубляющуюся модель того, кто вы, на протяжении сессий. Запускайте его на VPS за $5, на кластере GPU или на бессерверной инфраструктуре, которая почти ничего не стоит в простое. Он не привязан к вашему ноутбуку — общайтесь с ним из Telegram, пока он работает на облачной виртуальной машине.
Используйте любую модель, какую захотите — [Nous Portal](https://portal.nousresearch.com), OpenRouter, OpenAI, собственную конечную точку и [многие другие](https://hermes-agent.nousresearch.com/docs/integrations/providers). Переключайтесь с помощью `hermes model` — без изменений кода, без привязки к вендору.
<table>
<tr><td><b>Настоящий терминальный интерфейс</b></td><td>Полноценный TUI с многострочным редактированием, автодополнением слэш-команд, историей разговоров, прерыванием и перенаправлением, а также потоковым выводом инструментов.</td></tr>
<tr><td><b>Живёт там же, где и вы</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal и CLI — всё из единого процесса шлюза. Транскрипция голосовых сообщений, непрерывность разговоров между платформами.</td></tr>
<tr><td><b>Замкнутый цикл обучения</b></td><td>Память, курируемая агентом, с периодическими напоминаниями. Автономное создание навыков после сложных задач. Навыки самоулучшаются в процессе использования. Поиск по сессиям FTS5 с суммаризацией через LLM для припоминания между сессиями. Диалектическое моделирование пользователя через <a href="https://github.com/plastic-labs/honcho">Honcho</a>. Совместимость с открытым стандартом <a href="https://agentskills.io">agentskills.io</a>.</td></tr>
<tr><td><b>Запланированные автоматизации</b></td><td>Встроенный планировщик cron с доставкой на любую платформу. Ежедневные отчёты, ночные резервные копии, еженедельные аудиты — всё на естественном языке, работающее без присмотра.</td></tr>
<tr><td><b>Делегирует и распараллеливает</b></td><td>Порождайте изолированных субагентов для параллельных рабочих потоков. В Desktop выбирайте их провайдера, модель и лимиты в разделе Settings → Model → Subagents, затем примените полный маршрут. Пишите скрипты на Python, которые вызывают инструменты через RPC, превращая многошаговые конвейеры в ходы с нулевой стоимостью контекста.</td></tr>
<tr><td><b>Работает где угодно, не только на вашем ноутбуке</b></td><td>Семь терминальных бэкендов — локальный, Docker, SSH, Singularity, Modal, Daytona и Vercel Sandbox. Daytona и Modal предлагают бессерверную персистентность — окружение вашего агента засыпает в простое и просыпается по требованию, почти ничего не сто́я между сессиями. Запускайте его на VPS за $5 или на кластере GPU.</td></tr>
<tr><td><b>Готов к исследованиям</b></td><td>Пакетная генерация траекторий, сжатие траекторий для обучения следующего поколения моделей, вызывающих инструменты.</td></tr>
</table>
---
## Быстрая установка
### Linux, macOS, WSL2
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
### Windows (нативно, PowerShell)
> **Внимание:** нативный Windows запускает Hermes без WSL — CLI, шлюз, TUI и инструменты работают нативно. Если вы предпочитаете использовать WSL2, приведённая выше однострочная команда для Linux/macOS работает и там. Нашли ошибку? Пожалуйста, [сообщите о ней](https://github.com/NousResearch/hermes-agent/issues).
Выполните это в PowerShell:
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
Исходный установщик делегирует Python 3.14, Node.js, npm, ripgrep, FFmpeg
и зависимости Python в PM. Если Git отсутствует, он размещает проверенный архив Git
for Windows в хранилище инструментов Hermes. Он не заменяет ваш системный Git.
См. [способы установки](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
для отдельного пакета MSIX/App Installer и его порядка обновления.
> **Android / Termux:** Для устройств aarch64 доступен подписанный репозиторий APT с каналом `stable` (тегированные релизы) и предварительным каналом `canary`. Пакет включает Python, Node.js и TUI. Используйте [руководство по Termux](https://hermes-agent.nousresearch.com/docs/getting-started/termux), а не скрипт установщика для десктопа/сервера.
>
> **Windows:** Нативный Windows полностью поддерживается — однострочная команда PowerShell выше устанавливает всё. Если вы предпочитаете WSL2, команда для Linux работает и там. Нативная установка для Windows размещается в `%LOCALAPPDATA%\hermes`; установка в WSL2 — в `~/.hermes`, как и в Linux.
После установки:
```bash
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, которые скачивают и устанавливают пакеты.
**Чтобы убедиться, что ваша копия подлинная:**
```powershell
# 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 (Protection > Antivirus > Settings > Manage Exceptions)
- Добавляйте в белый список **папку**, а не хеш файла — Hermes обновляет `uv`, и хеш меняется с каждой версией
Для получения дополнительной информации см. отчёты Astral в upstream: [astral-sh/uv#13553](https://github.com/astral-sh/uv/issues/13553), [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011), [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## Начало работы
```bash
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
```
📖 **[Полная документация →](https://hermes-agent.nousresearch.com/docs/)**
---
## Пропустите сбор API-ключей — Nous Portal
Hermes работает с любым провайдером, который вы хотите — это не меняется. Но если вы предпочитаете не собирать пять отдельных API-ключей для модели, веб-поиска, генерации изображений, TTS и облачного браузера, **[Nous Portal](https://portal.nousresearch.com)** покрывает их все по одной подписке:
- **300+ моделей** — выберите любую из них с помощью `/model <name>`
- **Tool Gateway** — веб-поиск, генерация изображений (FAL), синтез речи (OpenAI), облачный браузер (Browser Use), всё маршрутизируется через вашу подписку. Никаких дополнительных аккаунтов.
Одна команда из свежей установки:
```bash
hermes setup --portal
```
Это выполняет вход через OAuth, устанавливает Nous в качестве вашего провайдера и включает Tool Gateway. Проверить текущую конфигурацию можно в любой момент с помощью `hermes portal info`. Подробности на [странице документации Tool Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway).
Вы по-прежнему можете подключать собственные ключи для каждого инструмента, когда захотите — шлюз работает на уровне отдельного бэкенда, а не по принципу «всё или ничего».
---
## Краткий справочник: CLI и мессенджеры
У Hermes две точки входа: запустите терминальный интерфейс командой `hermes` или запустите шлюз и общайтесь с ним через Telegram, Discord, Slack, WhatsApp, Signal или Email. После того как вы окажетесь в диалоге, многие слэш-команды работают одинаково в обоих интерфейсах.
| Действие | CLI | Платформы обмена сообщениями |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| Начать общение | `hermes` | Выполните `hermes gateway setup` + `hermes gateway start`, затем отправьте боту сообщение |
| Начать новый диалог | `/new` или `/reset` | `/new` или `/reset` |
| Сменить модель | `/model [provider:model]` | `/model [provider:model]` |
| Задать персоналию | `/personality [name]` | `/personality [name]` |
| Повторить или отменить последний ход | `/retry`, `/undo` | `/retry`, `/undo` |
| Сжать контекст / проверить использование | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` |
| Просмотреть навыки | `/skills` или `/<skill-name>` | `/<skill-name>` |
| Прервать текущую работу | `Ctrl+C` или отправить новое сообщение | `/stop` или отправить новое сообщение |
| Статус для конкретной платформы | `/platforms` | `/status`, `/sethome` |
Полные списки команд см. в [руководстве по CLI](https://hermes-agent.nousresearch.com/docs/user-guide/cli) и [руководстве по Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
---
## Документация
Вся документация доступна по адресу **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
| Раздел | Что рассматривается |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Быстрый старт](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Установка → настройка → первый разговор за 2 минуты |
| [Использование CLI](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Команды, сочетания клавиш, персоны, сессии |
| [Конфигурация](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | Файл конфигурации, провайдеры, модели, все параметры |
| [Шлюз обмена сообщениями](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| [Безопасность](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Подтверждение команд, сопряжение в личных сообщениях, изоляция контейнеров |
| [Инструменты и наборы инструментов](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | Более 40 инструментов, система наборов инструментов, терминальные бэкенды |
| [Система навыков](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Процедурная память, Skills Hub, создание навыков |
| [Память](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Постоянная память, профили пользователей, лучшие практики |
| [Интеграция MCP](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Подключение любого MCP-сервера для расширенных возможностей |
| [Планирование по cron](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Запланированные задачи с доставкой на платформы |
| [Файлы контекста](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Контекст проекта, определяющий каждый разговор |
| [Архитектура](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Структура проекта, цикл агента, ключевые классы |
| [Участие в разработке](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Настройка среды разработки, процесс PR, стиль кода |
| [Справочник CLI](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | Все команды и флаги |
| [Переменные окружения](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Полный справочник переменных окружения |
---
## Миграция из OpenClaw
Если вы переходите из OpenClaw, Hermes может автоматически импортировать ваши настройки, воспоминания, навыки и API-ключи.
**При первой настройке:** мастер настройки (`hermes setup`) автоматически обнаруживает `~/.openclaw` и предлагает выполнить миграцию перед началом конфигурации.
**В любое время после установки:**
```bash
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** — файл персоны
- **Memories** — записи MEMORY.md и USER.md
- **Skills** — созданные пользователем навыки → `~/.hermes/skills/openclaw-imports/`
- **Command allowlist** — шаблоны подтверждений
- **Messaging settings** — конфигурации платформ, разрешённые пользователи, рабочий каталог
- **API keys** — секреты из белого списка (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
- **TTS assets** — аудиофайлы рабочей области
- **Workspace instructions** — AGENTS.md (с `--workspace-target`)
Все параметры см. в `hermes claw migrate --help` или используйте навык `openclaw-migration` для интерактивной миграции под руководством агента с предварительным просмотром в режиме dry-run.
---
## Участие в разработке
Мы приветствуем вклад! См. [Contributing Guide](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) для настройки среды разработки, стиля кода и процесса PR.
Начните с [PM developer workflow](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)
для активации, повседневного использования, изменения зависимостей и выхода из окружения.
[Development Setup](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) описывает отдельную тестовую среду и команды проверки.
---
## Сообщество
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — MCP-сервер управления рабочим столом Linux для Hermes и других MCP-хостов, с деревьями доступности AT-SPI, вводом Wayland/X11, скриншотами и нацеливанием на окна композитора.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — мост WeChat от сообщества: запуск Hermes Agent и OpenClaw в одном аккаунте WeChat.
---
## Лицензия
MIT — см. [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE).
Создано [Nous Research](https://nousresearch.com).