All plugins

hermes-lang-uk

Ukrainian localization for the original Hermes Agent CLI, TUI and Desktop. Disclosure — text-only catalogs plus a Desktop plugin.js that only registers the Ukrainian locale through the Desktop SDK (no capabilities, network or file access); registering the pack never changes display.language, the user opts in via config.

angusvka-specGeneralv0.5.0Updated 2 days ago

About

Ukrainian localization for the original Hermes Agent CLI, TUI and Desktop. Disclosure — text-only catalogs plus a Desktop plugin.js that only registers the Ukrainian locale through the Desktop SDK (no capabilities, network or file access); registering the pack never changes display.language, the user opts in via config.

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 commit 3b421578588243f920886e6fe79a6faa87ea026e (release 0.23.1).
    Later releases may introduce new keys and show English fallback text.
  • Hermes Desktop must expose the ctx.i18n.registerAppLocale plugin 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

  1. Open Capabilities → Plugins → Install from Git in Hermes Desktop.

  2. Paste this repository URL:

    https://github.com/angusvka-spec/hermes-lang-uk
    
  3. Review the package and install both components when prompted: the agent language
    catalogs and the Desktop companion. Enable the plugin if it is disabled.

  4. 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

  1. Download the versioned ZIP and SHA256SUMS.txt from Releases.

  2. Extract the ZIP outside your Hermes data directory. Close Hermes before replacing a plugin.

  3. Windows: with Python 3.10+ installed, double-click INSTALL.cmd.
    macOS/Linux: run python3 install.py from the extracted folder.

  4. For a custom Hermes data directory or profile, pass its path explicitly:

    python install.py --home "/path/to/your/hermes-home"
    
  5. Enable hermes-lang-uk in 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. Check HERMES_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.
  • hermes not 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 --home with 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.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section