Languages
Use Empryo in English, Arabic, French, Korean or Russian. Switch live, get a mirrored desktop layout for Arabic, and see numbers and dates in your locale.
Copy & share
On this page8 sections
OverviewLink to this section
You can use Empryo in your own language. The terminal interface (TUI), the desktop app and headless runs all use the same translations. Five languages ship with the app:
| Language | Tag | Direction |
|---|---|---|
| English | en | left-to-right |
| العربية Arabic | ar | right-to-left |
| français French | fr | left-to-right |
| 한국어 Korean | ko | left-to-right |
| Русский Russian | ru | left-to-right |
The language picker shows how much of each language is translated. If a translation is missing a line, you see the English text instead of a blank.
SwitchingLink to this section
| Where | How |
|---|---|
| TUI | Run /language (or /lang, /locale). The interface updates in place, with no restart. |
| Desktop | Open Settings → Language and pick a language. The window reloads in the new language. |
| Headless | Pass --locale <tag> for one run, or set EMPRYO_LOCALE in your environment. |
You can also choose to follow your system language.
When more than one setting applies, Empryo uses the first one it finds:
- The
--localeflag. - The
EMPRYO_LOCALEenvironment variable. - The
localesetting in your config. A project config beats your global config. - Your operating system's language.
If you ask for a tag Empryo does not have exactly, it picks the closest match. For example, fr-CA gives you French. If nothing matches, you get English.
Right-to-leftLink to this section
In Arabic, the desktop app mirrors its layout:
- The layout flips. Spacing, borders and alignment all switch sides.
- Controls flip too. Sliders, menus, tabs and toggle groups work right-to-left. Submenus open on the correct side, and the <kbd>←</kbd> and <kbd>→</kbd> keys move the expected way.
- Each message gets the right direction. Prompts to a coding agent often start with a file path or a command. A browser would read a line like
src/auth.ts فيه خطأ في السطر ٤٢as left-to-right because of that first word. Empryo ignores code-like words, counts the rest, and shows the line in the direction it was written. - Code stays left-to-right. Paths, names, inline code, code blocks and diffs keep their own direction inside Arabic text, so the words around them stay in order.
- Messages and interface are independent. An Arabic message in an English interface reads right-to-left without flipping the rest of the screen, and the other way round.
The TUI does not mirror. Terminals do not reorder mixed-direction text. You still see the Arabic translation, but the layout stays left-to-right.
Numbers, dates and countsLink to this section
Numbers and times follow your language. A token count shows as 12.4K in English and 12,4 k in French. Relative times use natural phrasing, such as "yesterday" in English, «вчера» in Russian and "أمس" in Arabic.
Costs always show in US dollars, because that is how model providers bill. Only the number format changes.
Chinese, Japanese, KoreanLink to this section
In the desktop app, Empryo adds a small space where Latin text meets Chinese, Japanese or Korean characters. It also uses strict line-breaking rules, so a line never starts with a closing bracket or certain punctuation.
Live translationsLink to this section
Translations can improve between Empryo releases. With the liveTranslations setting on and a language other than English selected, the TUI and the desktop app check for newer translations once when they start, and skip the check if the last one was less than 6 hours ago. They never check again while they run. English is built in, so an English interface checks only when you ask it to (/language refresh in the TUI, or Settings → Language in the desktop app). Every check also finds languages that contributors added, so those show up in the language picker. The download is anonymous. Empryo checks every file before using it and rejects anything unsafe or malformed. It saves good files on your computer.
This setting is on by default. Set "liveTranslations": false in your config to turn it off. In the desktop app, you can also switch it off or check for updates from Settings → Language.
Headless runs never download translations. They use what the TUI or desktop app already saved.
Localized commandsLink to this section
Turn on localizedCommands to type slash commands in your interface language. The English names keep working. For example, /لغة runs /language. This setting is off by default.
Contributing a languageLink to this section
Translations are published in the locales folder of the proxysoul/Empryo repository on GitHub. To fix a translation or add a new language, open a pull request there. With live translations on, merged changes can reach you before the next release.