eng-to-ru-transcriber 0.2.0

automatic English-to-Cyrillic text transcriber

English-to-Russian Phonetic Transcriber 🔤

Читать на русском языке

A Python library for automatic English-to-Cyrillic text transcription using a hybrid engine: dictionary lookup and neural G2P (gruut) for unknown words.

💡 Features

• Universal transcription — handles any English text, including invented words, neologisms, and rare names.
• Custom vocabulary — augment the built-in dictionary with your own overrides.

⚡ Key Highlights

• Two-tier lookup — IPA via local 120k+ dict + neural G2P backup.
• Graphemic adaptation — Cyrillic matches Russian orthography.

🚀 Installation

pip install eng-to-ru-transcriber

💻 Usage

Basic Example

from eng_to_ru_transcriber import Transcriber

t = Transcriber()
print(t.transcribe("Hello world"))
# → Хэлоу уорлд

Custom Vocabulary

from eng_to_ru_transcriber import Transcriber

custom_vocabulary = {"python": "ˈpaɪθɑn"}
t = Transcriber(custom_vocabulary=custom_vocabulary)
print(t.transcribe("Python is great"))

🧪 Testing

pip install pytest
pytest

📊 Data Sources

Based on curated IPA data from OpenWiktionary.

📜 License

MIT