{"id":51516707,"url":"https://github.com/timoncool/hermes-ru-locale","last_synced_at":"2026-07-08T12:30:24.266Z","repository":{"id":369782327,"uuid":"1290660827","full_name":"timoncool/hermes-ru-locale","owner":"timoncool","description":"Полная русская локализация Hermes Agent Desktop — 2218 ключей, defineLocale, автоустановка. TypeScript.","archived":false,"fork":false,"pushed_at":"2026-07-06T22:57:17.000Z","size":1085,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-07-07T00:13:26.505Z","etag":null,"topics":["define-locale","hermes-agent","hermes-desktop","locale","localization","russian","translation","typescript","windows"],"latest_commit_sha":null,"homepage":"https://github.com/nousresearch/hermes-agent","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timoncool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://github.com/timoncool/ACE-Step-Studio/blob/master/DONATE.md","https://dalink.to/nerual_dreming","https://boosty.to/neuro_art"]}},"created_at":"2026-07-06T06:12:56.000Z","updated_at":"2026-07-06T23:59:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/timoncool/hermes-ru-locale","commit_stats":null,"previous_names":["timoncool/hermes-ru-locale"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/timoncool/hermes-ru-locale","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoncool%2Fhermes-ru-locale","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoncool%2Fhermes-ru-locale/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoncool%2Fhermes-ru-locale/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoncool%2Fhermes-ru-locale/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timoncool","download_url":"https://codeload.github.com/timoncool/hermes-ru-locale/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoncool%2Fhermes-ru-locale/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35265380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["define-locale","hermes-agent","hermes-desktop","locale","localization","russian","translation","typescript","windows"],"created_at":"2026-07-08T12:30:23.429Z","updated_at":"2026-07-08T12:30:24.246Z","avatar_url":"https://github.com/timoncool.png","language":"TypeScript","funding_links":["https://github.com/timoncool/ACE-Step-Studio/blob/master/DONATE.md","https://dalink.to/nerual_dreming","https://boosty.to/neuro_art"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Hermes Agent — Русская локализация\n\n**Полный перевод интерфейса Hermes Agent Desktop на русский язык — 2218 строк, defineLocale, автоустановка.**\n\n[![License](https://img.shields.io/github/license/timoncool/hermes-ru-locale?style=flat-square)](LICENSE)\n[![Stars](https://img.shields.io/github/stars/timoncool/hermes-ru-locale?style=flat-square)](https://github.com/timoncool/hermes-ru-locale/stargazers)\n[![Last Commit](https://img.shields.io/github/last-commit/timoncool/hermes-ru-locale?style=flat-square)](https://github.com/timoncool/hermes-ru-locale/commits)\n[![Hermes](https://img.shields.io/badge/Hermes%20Agent-v0.18.0-6366f1?style=flat-square)](https://github.com/nousresearch/hermes-agent)\n[![Status](https://img.shields.io/badge/status-beta-orange?style=flat-square)](https://github.com/timoncool/hermes-ru-locale)\n\n![Скриншот Hermes Agent на русском](docs/screenshots/screenshot-main.png)\n\n\u003c/div\u003e\n\n## Описание\n\n\u003e ⚠️ **Бета-версия.** Этот перевод я делал для себя как тестовый проект для Hermes Agent. Всё работает, но могут быть шероховатости — если что, ваш Hermes сам разберётся.\n\nПолная русская локализация десктопного приложения [Hermes Agent](https://github.com/nousresearch/hermes-agent) от Nous Research — все 2218 ключей интерфейса переведены на русский язык. Перевод сделан через `defineLocale()` — механизм частичных переводов Hermes, поэтому **не ломается при обновлениях** (новые строки просто остаются на английском).\n\nУстановка за одну команду через PowerShell: авто-определение пути Hermes, копирование файлов, патч конфигов TypeScript и сборка.\n\n## Возможности\n\n- **2218 переведённых ключей** — весь интерфейс Hermes Agent Desktop на русском\n- **defineLocale** — частичный перевод, не ломается при обновлении Hermes\n- **Автоустановка** — `install.ps1` сам найдёт Hermes, скопирует файлы, пропатчит конфиги\n- **Перевод констант** — названия и описания полей настроек тоже на русском\n- **Алиасы раскладок** — `ru`, `ru-ru`, `ru_ru`, `русский` — любой вариант работает\n- **Один файл перевода** — `ru.ts` содержит всё, легко править и дополнять\n- **Windows** — скрипт установки под PowerShell (Windows 10/11)\n\n## Быстрый старт\n\n### Самый простой способ — через Hermes\n\nОткройте чат с Hermes и скажите:\n\n\u003e Установи русскую локализацию из https://github.com/timoncool/hermes-ru-locale\n\nHermes сам склонирует репо, скопирует файлы, пропатчит конфиги TypeScript и соберёт десктоп. После этого:\n\n```\nHermes Desktop → Settings → Appearance → Русский\n```\n\n### Ручная установка (PowerShell)\n\n```powershell\ngit clone https://github.com/timoncool/hermes-ru-locale.git\ncd hermes-ru-locale\npowershell -ExecutionPolicy Bypass -File install.ps1\n```\n\n## Ручная установка\n\nЕсли автоустановщик не сработал:\n\n```powershell\n# Копируем файлы перевода\ncopy ru.ts %LOCALAPPDATA%\\hermes\\hermes-agent\\apps\\desktop\\src\\i18n\\ru.ts\ncopy ru-constants.ts %LOCALAPPDATA%\\hermes\\hermes-agent\\apps\\desktop\\src\\app\\settings\\ru-constants.ts\n\n# Добавляем 'ru' в types.ts (если ещё нет)\n# export type Locale = 'en' | 'zh' | 'zh-hant' | 'ja' | 'ru'\n\n# Регистрируем в catalog.ts:\n# import { ru } from './ru'\n# ...ru в массиве locales...\n\n# Добавляем в languages.ts:\n# { id: 'ru', name: 'Русский', englishName: 'Russian', configValue: 'ru' }\n\n# Собираем\ncd %LOCALAPPDATA%\\hermes\\hermes-agent\\apps\\desktop\nnpm run build\n```\n\n## Что в пакете\n\n| Файл | Назначение | Объём |\n|------|-----------|-------|\n| `ru.ts` | Основной перевод интерфейса (defineLocale) | 2218 строк |\n| `ru-constants.ts` | Перевод названий и описаний настроек | 60 строк |\n| `install.ps1` | Автоустановщик для Windows | 90 строк |\n\n## Как это работает\n\n`ru.ts` использует `defineLocale()` — механизм Hermes для частичных переводов. Любые ключи, отсутствующие в русском переводе, автоматически подставляются из английского. Это значит, что перевод **не ломается при обновлении Hermes** — новые строки просто будут на английском, пока их не переведут.\n\n`install.ps1` автоматически:\n1. Находит установку Hermes (через `hermes` в PATH или `%LOCALAPPDATA%\\hermes`)\n2. Копирует `ru.ts` и `ru-constants.ts`\n3. Пропатчивает `types.ts`, `catalog.ts`, `languages.ts`\n4. Запускает `npm run build`\n\n## Требования\n\n- **Hermes Agent** v0.18.0 или новее (установлен из исходников)\n- **Node.js** и **npm** (для сборки десктопа)\n- **Windows 10/11** (скрипт установки — PowerShell)\n\n## Скриншоты\n\n![Окно чата на русском](docs/screenshots/screenshot-chat.png)\n\n![Страница настроек на русском](docs/screenshots/screenshot-settings.png)\n\n![Выбор языка в настройках](docs/screenshots/screenshot-appearance.png)\n\n## Решение проблем\n\n### Hermes не запускается после установки\n\nУ меня регулярно Hermes отказывался запускаться после правок в исходниках. Лечится просто:\n\n1. Скачайте свежий установщик Hermes Agent\n2. Запустите его — установка **поверх** существующей (данные сохранятся: конфиги, сессии, навыки, память)\n3. Hermes снова работает, русский язык на месте — перезапускать `install.ps1` не нужно\n\nЕсли что-то пошло не так — **ваш же Hermes вам и поможет с этим справиться.** Спросите у него в чате: «Hermes не запускается после установки русской локали, что делать?» — он в курсе своей архитектуры и подскажет.\n\n## Обновление перевода\n\nПри обновлении Hermes Agent — просто запустите `install.ps1` заново. Новые непереведённые строки будут на английском, остальное останется на русском.\n\nХотите помочь с переводом новых строк? Pull requests приветствуются — править нужно только `ru.ts`.\n\n## Другие проекты\n\n| Проект | Описание |\n|--------|----------|\n| [ACE-Step Studio](https://github.com/timoncool/ACE-Step-Studio) | AI-студия музыки — песни, вокал, каверы, клипы |\n| [telegram-api-mcp](https://github.com/timoncool/telegram-api-mcp) | Telegram Bot API как MCP-сервер |\n| [civitai-mcp-ultimate](https://github.com/timoncool/civitai-mcp-ultimate) | Civitai API как MCP-сервер |\n| [VideoSOS](https://github.com/timoncool/videosos) | AI-видеопродакшн в браузере |\n| [GitLife](https://github.com/timoncool/gitlife) | Жизнь в неделях — интерактивный календарь |\n| [ScreenSavy.com](https://github.com/timoncool/ScreenSavy.com) | Генератор эмбиент-экранов |\n\n## Авторы\n\n- **Nerual Dreming** — [Telegram](https://t.me/nerual_dreming) | [neuro-cartel.com](https://neuro-cartel.com) | [ArtGeneration.me](https://artgeneration.me)\n- Основано на переводе [warment/hermes-desktop-ru](https://github.com/warment/hermes-desktop-ru)\n\n## Поддержать автора\n\nЯ создаю опенсорс софт и занимаюсь исследованиями в области ИИ. Большая часть всего, что я делаю, находится в открытом доступе. Ваши пожертвования позволяют мне создавать и исследовать больше, не отвлекаясь на поиск еды для продолжения существования =)\n\n**[Все способы поддержки](https://github.com/timoncool/ACE-Step-Studio/blob/master/DONATE.md)** | **[dalink.to/nerual_dreming](https://dalink.to/nerual_dreming)** | **[boosty.to/neuro_art](https://boosty.to/neuro_art)**\n\n- **BTC:** `1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC`\n- **ETH (ERC20):** `0xb5db65adf478983186d4897ba92fe2c25c594a0c`\n- **USDT (TRC20):** `TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C`\n\n## Star History\n\n\u003ca href=\"https://github.com/timoncool/hermes-ru-locale/stargazers\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/stars-dark.svg\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"docs/stars-light.svg\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"docs/stars-light.svg\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## Лицензия\n\nMIT — делайте что хотите, ссылка на автора приветствуется.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimoncool%2Fhermes-ru-locale","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimoncool%2Fhermes-ru-locale","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimoncool%2Fhermes-ru-locale/lists"}