Hermes Persian RTL: plugin for Hermes Agent

Desktop plugin for Hermes Agent that adds Vazirmatn Persian typography and automatic RTL text direction

What Hermes Persian RTL does

Hermes Persian RTL is a Hermes Agent Desktop plugin that fixes how Persian text looks and flows in the app. It applies the Vazirmatn font to Persian text across chat messages, prompts, sidebars, buttons and dialogs, Inter to English and other Latin text, and Geist Mono to code blocks, falling back to JetBrains Mono.

Its direction logic aligns Persian paragraphs right-to-left while English messages and code stay left-to-right. It uses the official desktop plugin folder, ~/.hermes/desktop-plugins/, and patches no Hermes core files, so Hermes updates do not overwrite it. A one-line PowerShell or bash installer is provided, and a manual install means placing plugin.js in a persian-font folder and choosing Reload desktop plugins from the Ctrl+K menu. A Persian guide is included in the repository.

Key features

Vazirmatn typography for Persian text throughout the desktop app
Inter for English and Latin text, Geist Mono for code with JetBrains Mono fallback
Automatic right-to-left alignment for Persian paragraphs
English text and code blocks stay left-to-right
No core patching, using the official desktop-plugins folder
Installers for Windows PowerShell and Linux or macOS bash

When to use it

Read and write Persian conversations in Hermes Agent Desktop with correct direction
Mix Persian prose with English terms and code blocks in the same chat
Keep a custom font setup that survives Hermes updates

Who it is for: Persian-speaking users of Hermes Agent Desktop.

How it fits with Hermes Agent

It is a plugin for Hermes Agent Desktop that loads from the app's official desktop-plugins directory.

How to install Hermes Persian RTL

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

iwr -useb https://raw.githubusercontent.com/Abulfadl-Ahmadi/hermes-persian-rtl/main/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/Abulfadl-Ahmadi/hermes-persian-rtl/main/install.sh | bash

Requirements: Hermes Agent Desktop; the first install line is for Windows PowerShell and the second for Linux or macOS

FAQ

What is Hermes Persian RTL?

Hermes Persian RTL is a Hermes Agent Desktop plugin that adds Vazirmatn Persian typography and smart right-to-left text handling.

How do I install Hermes Persian RTL?

On Windows, run the iwr install.ps1 line in PowerShell. On Linux or macOS, run the curl install.sh line in a terminal. For a manual install, put plugin.js in a persian-font folder inside the desktop-plugins directory and reload plugins.

Will Hermes updates remove Hermes Persian RTL?

No. It uses the official Hermes Desktop plugin folder and does not patch Hermes core files, so updates should not overwrite it.