hermes-desktop-ru

KO | EN

gitlite — search

#pytorch #sql #generative-ai #mysql #video #gpt #redis #framework #list #automation

hermes-desktop-ru

(★ 9)

🇷🇺 Полная русская локализация Hermes Desktop — Bots, Kanban и хардкод UI. Установщик с doctor, AI-мониторинг апстрима и быстрые релизы вслед за Hermes.

File Explorer

ZIP Download

- - general.md
- - bug.yml
  - config.yml
  - doctor-fail.yml
- - check.yml
  - experimental-posix.yml
- hermes-desktop-ru.mjs
- - bots-kanban.png
  - chat.png
  - settings.png
- ru-bots-locales.ts
- ru-constants.ts
- ru-locales-kanban.ts
- ru.ts
- - ru-bots-locales.ts
  - ru-constants.ts
  - ru-locales.ts
  - ru.ts
- apply-hardcodes.mjs
- build-release-zip.py
- deps-health.mjs
- EXPECTED_COMMIT
- gen-registry.mjs
- install-asar.ps1
- install.bat
- install.mjs
- install.ps1
- install.sh
- overrides.json
- probe-ru.mjs
- registry.json
- structural-i18n.mjs
- ru-mod-v3.patch
- release-check.sh
.gitattributes
.gitignore
AUTHORS.md
CHANGELOG.md
index.html
LICENSE
package-lock.json
package.json
README.en.md
README.md
UPSTREAM-WATCH.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[🇷🇺 Русский](README.md) · [🇬🇧 English](README.en.md)

Полная русская локализация [Hermes Desktop](https://github.com/NousResearch/hermes-agent).

[![Hermes Desktop](https://img.shields.io/badge/Hermes_Desktop-0.21.0-FFD700?style=for-the-badge&logo=github)](https://github.com/NousResearch/hermes-agent)
[![npm](https://img.shields.io/npm/v/hermes-desktop-ru?style=for-the-badge&color=red)](https://www.npmjs.com/package/hermes-desktop-ru)
[![npm](https://img.shields.io/npm/dm/hermes-desktop-ru?style=for-the-badge&color=red)](https://www.npmjs.com/package/hermes-desktop-ru)
[![Release](https://img.shields.io/github/v/release/upmeister/hermes-desktop-ru?style=for-the-badge&color=green)](https://github.com/upmeister/hermes-desktop-ru/releases)
[![Downloads](https://img.shields.io/github/downloads/upmeister/hermes-desktop-ru/total?style=for-the-badge&color=orange)](https://github.com/upmeister/hermes-desktop-ru/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](https://raw.githubusercontent.com/upmeister/hermes-desktop-ru/master/LICENSE)

**Последний релиз: [v1.2.4](https://github.com/upmeister/hermes-desktop-ru/releases/tag/v1.2.4) · Hermes 0.21.0 · 3 сентября 2026**  
**Статус: frozen maintenance** — новые переводы не добавляются, только поддержка хардкодов, пока апстрим их не вынесет.

## Зачем этот мод

Официальная русская локализация Hermes Agent (`ru.ts`) вошла в `main` 1 сентября 2026 года в коммите [`a922dad9`](https://github.com/NousResearch/hermes-agent/commit/a922dad9) (v0.21+). Она покрывает около 60% интерфейса, но некоторые компоненты по-прежнему содержат **хардкоды** на английском: Bots, Kanban, отдельные группы настроек, сообщения main-процесса и метаданные плагинов.

Этот мод дополняет официальную локализацию, переводя оставшиеся хардкоды и уточняя спорные переводы терминов. Например, `Skills` / `Capabilities` официально переведён как «Возможности», хотя этот раздел посвящён skills, tools и MCP servers.

Подробные **конвенции перевода** и список покрываемых компонентов приведены ниже.

> Нужен Desktop **из исходников** (`hermes desktop` / `git clone`), не portable и не готовый установщик с сайта.
>
> **Windows** — основной путь. **Linux** — установщик прогнан автором (Ubuntu 26). **macOS** — экспериментально, живого прогона нет. Официальный подписанный `.app` / AppImage с сайта **не патчим**.

| | Официальный ru.ts (v0.21+) | Этот мод (хардкоды) |
|---|---|---|
| Каталог i18n (кнопки, настройки, онбординг) | ✅ ~2200 ключей | не трогает |
| Хардкоды компонентов: поля настроек, splash, мессенджеры | ❌ | ✅ |
| Боты, канбан, main-process (gateway auth, boot-failure) | ❌ | ✅ |
| Реестр doctor (746 правил `before→after`) | — | ✅ |
| После `hermes update` | строки из каталога обновляются | `hermes-desktop-ru install` |

## Как выглядит

![Чат](https://raw.githubusercontent.com/upmeister/hermes-desktop-ru/master/docs/screenshots/chat.png)

![Настройки](https://raw.githubusercontent.com/upmeister/hermes-desktop-ru/master/docs/screenshots/settings.png)

![Боты и канбан](https://raw.githubusercontent.com/upmeister/hermes-desktop-ru/master/docs/screenshots/bots-kanban.png)

## Установка

Нужны Node.js 18+ и **закрытый** Hermes Desktop (сборка 5–10 минут).

Обычный путь клона:

- Windows: `%LOCALAPPDATA%\hermes\hermes-agent`
- Linux / macOS: `~/.hermes/hermes-agent`

```bash
npm install -g hermes-desktop-ru
hermes-desktop-ru install
```

| Команда | Что делает |
|---|---|
| `hermes-desktop-ru install` | установить / переустановить. Откатывает tracked-исходники клона к стоку |
| `hermes-desktop-ru doctor` | сухая проверка: ничего не пишет, процессы не убивает |
| `hermes-desktop-ru uninstall` | вернуть packaged `app.asar` из `.stock.bak` (клон не трогает) |
| `hermes-desktop-ru version` | версия пакета |
| `hermes-desktop-ru help` | справка |

Клон не там, где обычно:

```bash
hermes-desktop-ru install --root /path/to/hermes-agent
```

Подойдут и `HERMES_AGENT_ROOT`, и `HERMES_HOME`.

Без npm: скачайте [release zip](https://github.com/upmeister/hermes-desktop-ru/releases), распакуйте.

- Windows: `install.bat` (двойной клик) или `install.ps1`
- Linux / macOS: `./install.sh` или `node install.mjs` (нужен Node 18+ в PATH; если Desktop уже собирался, его Node часто лежит в `~/.hermes/node`)

Перед установкой Desktop должен быть хотя бы раз собран из этого клона (`hermes desktop` или `cd apps/desktop && npm run pack`). Установщик ищет `app.asar` только внутри `apps/desktop/release/` (`win-unpacked` / `win-arm64-unpacked` / `linux-unpacked` / `linux-arm64-unpacked` / `Hermes.app`).

На Mac после подмены asar установщик ставит ad-hoc подпись. Это не нотаризация Apple: Gatekeeper может всё равно ругнуться. Если Desktop «повреждён» — вы не в том `.app` (нужен self-built из клона, не скачанный с сайта).

## После обновления Hermes

```text
hermes update  →  hermes-desktop-ru install  →  запуск Desktop
```

`hermes update` сам по себе **не** пересобирает уже установленный asar. Старый русский UI может «казаться живым» — это старый бандл. Всегда прогоняйте установщик.

Установщик сначала возвращает tracked-исходники клона к стоку. Если в том же клоне лежат другие ваши патчи — они не переживут установку. `doctor` этого не делает.

## Что покрывает мод (реестр хардкодов)

| Область | Покрытие |
|---|---|
| Хардкоды компонентов: поля настроек, splash, мессенджеры, темы | ✅ |
| Канбан, плагин Bots, сообщения main-процесса (gateway auth, boot-failure) | ✅ |
| Реестр doctor (якоря `before→after`) | ✅ 746 правил |

Официальный каталог `ru.ts` (v0.21+) покрывает i18n-строки отдельно — мод их не дублирует.

## Конвенции перевода

- Имена собственные не трогаем: платформы, плагины, провайдеры, модели, команды, имена тем (`Midnight`, `Catppuccin`). Описания тем — переводим.
- Технические термины оставляем как есть: MCP, DIFF, URL, PR, YOLO, JSON.
- Устоявшиеся подписи UI: Artifacts → «Рабочие материалы», Maintenance → «Обслуживание и диагностика», Reasoning → «Рассуждения».
- Устоявшийся термин `Skills` / `Capabilities` → **«Навыки и инструменты»** — официальный перевод «Возможности» не отражает содержание раздела (skills, tools, MCP servers).
- То, что приходит из бэкенда (логи, CLI, traceback, JSON, сообщения ОС), не переводим.
- Информация от внешних источников (провайдеры памяти, сторонние сервисы) тоже не переводится.

Перед записью гоняется **doctor**: косметический пропуск или неоднозначный якорь (часто в Bots) оставит пятно по-английски — установка идёт. Остановка только если пропал файл критичного правила (канбан / connection-registry).

Актуальная совместимость и журнал апстрима — в [релизах](https://github.com/upmeister/hermes-desktop-ru/releases) и [UPSTREAM-WATCH.md](UPSTREAM-WATCH.md).

## Если что-то пошло не так

| Симптом | Что сделать |
|---|---|
| «не найден клон hermes-agent» | `--root` или `HERMES_AGENT_ROOT` |
| «не найден packaged app.asar» | соберите Desktop из клона (`hermes desktop` / `npm run pack`). Prebuilt с сайта не подойдёт |
| Doctor FAIL | пропал файл критичного правила — [issue](https://github.com/upmeister/hermes-desktop-ru/issues/new?template=doctor-fail.yml) |
| Doctor WARN, часть UI на английском | нормально после большого апдейта Bots; дождитесь следующего релиза мода или поставьте как есть |
| Пара сотен MISSING при установке на свежий Hermes | нормально: Hermes обновляется по несколько раз в день, а мод — нет. Крупное обновление иногда меняет целые паки локалей разом (так слетали 300+ правил в рамках одной минорной версии). Мод при этом почти всегда ставится и работает — критичные поломки он определяет сам. Если видите ошибку перевода или установщика — создавайте issue, так вы поможете и себе, и другим |
| Access is denied / EBUSY / файл занят | закройте Desktop и шлюз, повторите |
| macOS: «приложение повреждено» / Gatekeeper | мод только для self-built `.app` из клона, не для скачанного с сайта |
| Долго на npm ci | нормально после `hermes update` (3–10 мин) |
| Часть UI на английском | `doctor`, затем `install`, перезапуск |
| Откатить мод | `hermes-desktop-ru uninstall` (нужен `.stock.bak` от прошлой установки). Или руками: закройте Desktop → замените `resources/app.asar` на `resources/app.asar.stock.bak` → запустите. Полный сброс клона — `hermes update` |

Баги и непереведённые места: [GitHub Issues](https://github.com/upmeister/hermes-desktop-ru/issues/new/choose).

Как это устроено технически (реестр якорей, doctor, asar) — в [английском README](README.en.md).

## Основа

- [warment/hermes-desktop-ru](https://github.com/warment/hermes-desktop-ru) — ранняя база перевода
- [anatolijlaptev1991-ctrl/hermes-ru](https://github.com/anatolijlaptev1991-ctrl/hermes-ru) — идеи structural/doctor
- DrMaks22 — словарь и PR [#72250](https://github.com/NousResearch/hermes-agent/pull/72250)

[MIT](LICENSE)

hermes-desktop-ru

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README