English to Monsu Translator

A zero-dependency Python CLI and library that translates English text into the fictional Monsu language using a word dictionary.

Quick start

Install and translate:

git clone https://github.com/rkriad585/EMTranslator.git
cd EMTranslator
pip install -e .
emtrans "Hello world"
# Monsu_1 monsu_2

Or use the library:

from emtranslator import Translator

t = Translator()
print(t.translate("Hello world"))  # Monsu_1 monsu_2

Key features

• Word-by-word translation from a built-in 90-word English-to-Monsu dictionary.
• Reverse (Monsu to English) translation via -r/--reverse or Translator(reverse=True).
• Punctuation-, whitespace-, and casing-preserving output.
• Unknown words kept as-is and reported via missing_words() / --json.
• Extensible user dictionary persisted at ~/.config/neostore/emtranslator/config.toml.
• Zero dependencies — standard library only.

Screenshot

See all screenshots on the Screenshots page.

Documentation

• Getting Started
• Installation
• Usage
• CLI Reference
• Configuration
• Architecture
• Development
• Deployment
• FAQ
• Troubleshooting

License

Distributed under the MIT License.