Hermes Atlas
Guides, templates & lists

Hermes Russian Locale

timoncool/hermes-ru-locale

Full Russian translation of the Hermes Agent Desktop interface with 2218 keys and a PowerShell installer

In short

Hermes Russian Locale is a complete Russian translation of the Hermes Agent Desktop interface, covering 2218 interface keys. It is built with Hermes' defineLocale mechanism so that Hermes updates do not break it.

What Hermes Russian Locale does

The translation lives in one file, ru.ts, plus ru-constants.ts for the names and descriptions of settings fields. Because it uses defineLocale(), the Hermes mechanism for partial translations, any key missing from the Russian file falls back to English, so new strings added by a Hermes update simply appear in English until they are translated. The locale aliases ru, ru-ru, ru_ru and the Russian word for Russian all resolve to the same language.

install.ps1 finds the Hermes install through PATH or the local app data folder, copies the two files, patches types.ts, catalog.ts and languages.ts, and runs npm run build. A manual route copies the files and edits those three registrations by hand. Afterward you select Russian under Settings, then Appearance, in Hermes Desktop. The README also suggests asking Hermes itself to install the locale from the repository URL. The author wrote it for personal testing and labels it a beta.

Key features

  • 2218 translated interface keys for Hermes Agent Desktop
  • defineLocale partial translation, so untranslated new strings fall back to English
  • install.ps1 that locates Hermes, copies files, patches the config and builds the app
  • Translated settings names and descriptions in ru-constants.ts
  • Locale aliases ru, ru-ru and ru_ru

When to use it

  • Using Hermes Agent Desktop in Russian
  • Reapplying the translation after a Hermes update by re-running install.ps1
  • Contributing translations of new strings by editing ru.ts

Who it is for: Russian-speaking users of Hermes Agent Desktop on Windows.

How it fits with Hermes Agent

It is a localization pack for the Hermes Agent Desktop app and depends on Hermes' own locale system.

How to install Hermes Russian Locale

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/timoncool/hermes-ru-locale.git
cd hermes-ru-locale
powershell -ExecutionPolicy Bypass -File install.ps1

Requirements: Hermes Agent v0.18.0 or newer installed from source, Node.js and npm for the desktop build, and Windows 10 or 11 for the PowerShell installer

Note: The README labels this a beta made for the author's own testing, and the installer patches Hermes Desktop source files and rebuilds the app.

FAQ

What is Hermes Russian Locale?

Hermes Russian Locale is a full Russian translation of the Hermes Agent Desktop interface. It covers 2218 keys and installs with a PowerShell script.

Does Hermes Russian Locale work with Hermes Agent?

Yes, it targets the Hermes Agent Desktop app, version 0.18.0 or newer installed from source. After updating Hermes, re-run install.ps1; any new untranslated strings stay in English.

What do I need to run Hermes Russian Locale?

You need Hermes Agent v0.18.0 or newer built from source, Node.js with npm, and Windows 10 or 11 for the PowerShell installer. The installer patches three TypeScript files and runs npm run build.

Similar resources for Hermes Agent

All resources

Related guides: SOUL.md for Hermes Agent: what it is and how to write one · What is Hermes Agent?