cyrtranslit

library1.2.0pypypi✓ verified 87d ago

Bi-directional Cyrillic transliteration library supporting Belarusian, Bulgarian, Greek, Montenegrin, Macedonian, Mongolian, Russian, Serbian, Tajik, and Ukrainian. Current version 1.2.0, maintained on GitHub.

serialization

pip install cyrtranslit

github ↗package ↗

INSTALL

IMPORT

SIG · CYRTRANSLIT

cyrtranslit

serializationpythonv1.2.0

Install

1.5s avg

Import

10ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.010s · 17.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.5s · import 0.010s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cyrtranslit

✓ import cyrtranslit

✗ from cyrillic_transliteration import ...

The package name on PyPI is cyrtranslit, not cyrillic_transliteration.

Basic usage demonstrating to_latin and to_cyrillic with language codes.

import cyrtranslit # Transliterate Russian from Cyrillic to Latin cyrillic_text = "Привет мир" latin_text = cyrtranslit.to_latin(cyrillic_text, "ru") print(latin_text) # Output: Privet mir # Transliterate Serbian from Latin to Cyrillic latin_text = "Zdravo svete" cyrillic_text = cyrtranslit.to_cyrillic(latin_text, "sr") print(cyrillic_text) # Output: Здраво свете

Debug

Known issues

breakingVersion 1.2.0 changes default to not preserve accented vowels (Ѐ/ѐ, Ѝ/ѝ). To preserve accents, use preserve_accents=True parameter.

fix

Use cyrtranslit.to_latin(text, 'bg', preserve_accents=True) or cyrtranslit.to_latin(text, 'mk', preserve_accents=True) to keep grave accents.

affects: >=1.2.0

gotchaLanguage codes are case-sensitive and must be two-letter lowercase (e.g., 'ru', 'sr', 'uk').

fix

Always use lowercase language codes. Valid codes: 'be', 'bg', 'el', 'mk', 'mn', 'ru', 'sr', 'tg', 'uk'. 'mg' for Montenegrin is also supported.

affects: all

deprecatedPython 2 support has been dropped since version 0.4. The library no longer works with Python 2.

fix

Use Python 3.6 or newer.

affects: >=0.4

Errors

Common errors & fixes

KeyError: 'xx'

Using an unsupported or misspelled language code.

fix

Check supported codes: 'be', 'bg', 'el', 'mk', 'mn', 'ru', 'sr', 'tg', 'uk'. Use lowercase.

IndexError: string index out of range

This error occurred in older versions (<1.1.1) with Bulgarian words ending in 'sh'.

fix

Upgrade to cyrtranslit >=1.1.1.

ModuleNotFoundError: No module named 'cyrillic_transliteration'

Trying to import with the incorrect package name (the GitHub repo name).

fix

Use 'import cyrtranslit' (the PyPI package name).

Upgrade

Version history

1.2.0latest on PyPI · released Nov 20, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/opendatakosovo/cyrillic-transliteration ↗

packagehttps://pypi.org/project/cyrtranslit/ ↗