Ukrainian for Hermes Agent
Слава Україні! 🇺🇦 — Glory to Ukraine!
Українська інструкція · Download · MIT license
A Ukrainian language pack for Hermes Agent CLI, TUI and Hermes Desktop.
This is an add-on for an existing Hermes installation, not a separate Hermes application.
It includes 3,538 core messages, 1,445 TUI messages and 5,597 Desktop catalog entries.
Some upstream Hermes interfaces already include Ukrainian; this pack supplies terminology
adjustments and a complete Desktop companion that also works without a cached gateway catalog.
Requirements
- Hermes Agent 0.23.1 or later, with language-pack support. Compatibility is tested
against upstream commit3b421578588243f920886e6fe79a6faa87ea026e(release 0.23.1).
Later releases may introduce new keys and show English fallback text. - Hermes Desktop must expose the
ctx.i18n.registerAppLocaleplugin API. - Git is needed for installation from GitHub. The offline installer instead needs Python 3.10+.
- No administrator permissions, API key, model download or extra Python packages are needed for the pack.
Easiest: install in Hermes Desktop
-
Open Capabilities → Plugins → Install from Git in Hermes Desktop.
-
Paste this repository URL:
https://github.com/angusvka-spec/hermes-lang-uk -
Review the package and install both components when prompted: the agent language
catalogs and the Desktop companion. Enable the plugin if it is disabled. -
In the interface language setting, select Українська, then restart Hermes Desktop.
Menu labels may differ by Hermes version. No plugin capabilities are requested.
Hermes' scanner can flag translated help text mentioning .ssh or sudo.
Those matches are text inside the catalog, not file access or executed commands.
Review the package when prompted; do not disable security scanning.
CLI / TUI
Run these commands in a terminal where hermes is available:
hermes plugins install https://github.com/angusvka-spec/hermes-lang-uk
hermes plugins enable hermes-lang-uk
hermes config set display.language uk
Restart running Hermes sessions and gateways. The CLI installation covers CLI/TUI;
use the Desktop installation above or the offline installer below for the Desktop companion.
For a named profile, run the commands in that profile's Hermes environment.
An existing HERMES_LANGUAGE environment setting can override the selected language.
Offline / ZIP installation
-
Download the versioned ZIP and
SHA256SUMS.txtfrom Releases. -
Extract the ZIP outside your Hermes data directory. Close Hermes before replacing a plugin.
-
Windows: with Python 3.10+ installed, double-click
INSTALL.cmd.
macOS/Linux: runpython3 install.pyfrom the extracted folder. -
For a custom Hermes data directory or profile, pass its path explicitly:
python install.py --home "/path/to/your/hermes-home" -
Enable
hermes-lang-ukin Hermes, select Українська, and restart it.
CLI users can run the last two commands in the CLI section.
The installer respects HERMES_HOME. Otherwise it uses %LOCALAPPDATA%\hermes on
Windows and ~/.hermes on macOS/Linux, including HERMES_DATA_DIR_SUFFIX if set.
It refuses a directory without an existing Hermes configuration/state marker.
It copies only the language plugin and its Desktop companion. It leaves config,
credentials, conversations and other plugins untouched. Existing versions are backed
up under language-pack-backups/ in the selected Hermes home; a write failure restores them.
The installer does not enable the plugin or change your chosen language automatically.
Verify the ZIP on Windows with Get-FileHash .\hermes-lang-uk-0.5.0.zip -Algorithm SHA256,
on Linux with sha256sum -c SHA256SUMS.txt, or on macOS with shasum -a 256 -c SHA256SUMS.txt.
Updating and removing
Update through Hermes' Plugins interface, or download a new ZIP and rerun the offline
installer. To stop using the pack, switch the interface language to English, disable
the plugin in Hermes, then uninstall it using the Plugins interface. Keep the backup
until you have confirmed the update works. The offline installation can be restored
while Hermes is closed by moving its backed-up agent and desktop folders back to
plugins/hermes-lang-uk and desktop-plugins/hermes-lang-uk respectively.
Troubleshooting and limits
- Plugin installed but English remains: enable both components, select Ukrainian
for the active profile, and restart the application/gateway. CheckHERMES_LANGUAGE. - Unknown language / incompatible version: use a Hermes release with language-pack
support and the Desktop registration API. Do not edit the Hermes application files. hermesnot found: use the terminal/environment supplied by your Hermes installation,
or install through its Desktop Plugins interface.- Offline installer cannot find Hermes: start Hermes once, or use
--homewith its actual data directory. - This translates static UI text. Model answers, tool output, logs, web dashboard,
and slash-command names are not translated by this pack. Ask the model to answer in Ukrainian separately. - Desktop text includes generated translations. Not every sentence has been reviewed by a human.
Complete key coverage is not a guarantee of perfect wording. New Hermes releases may need an updated pack. - Offline installer tests and upstream integration checks were run on Windows.
See the repository's Actions tab for Windows/Linux CI results. macOS has not been tested.
The pack makes no network requests and requests no Desktop capabilities. Installing
Hermes or accessing this GitHub repository may itself require network access.
See verification, development and
attribution. Contributions should contain UI translations only;
never attach real conversations, keys, local configuration or personal documents.
Earlier installations
If an earlier version is installed under the former package name, disable and uninstall that version through Hermes before enabling hermes-lang-uk. Do not enable two Ukrainian packs together. This release requires Hermes 0.23.1 or later.
README from the reviewed commit 05dda20; it updates when the author re-pins.

angusvka-spec