xnum 0.5

XNum: Universal Numeral System Converter

XNum: Universal Numeral System Converter

---

Overview

XNum is a simple and lightweight Python library that helps you convert digits between different numeral systems — like English, Persian, Hindi, Arabic-Indic, Bengali, and more. It can automatically detect mixed numeral formats in a piece of text and convert only the numbers, leaving the rest untouched. Whether you're building multilingual apps or processing localized data, XNum makes it easy to handle numbers across different languages with a clean and easy-to-use API.

PyPI Counter
Github Stars

Branch	main	dev
CI

Code Quality

Installation

PyPI

• Check Python Packaging User Guide
• Run pip install xnum==0.5

Source code

• Download Version 0.5 or Latest Source
• Run pip install .

Usage

>>> from xnum import convert, NumeralSystem
>>> print(convert("۱۲۳ apples & ٤٥۶ cars", target=NumeralSystem.ENGLISH))
123 apples & 456 cars
>>> print(convert("۱۲۳ and ٤٥٦", source=NumeralSystem.PERSIAN, target=NumeralSystem.HINDI))
१२३ and ٤٥۶

ℹ️ By default, the source parameter is set to NumeralSystem.AUTO, which automatically detects the numeral system

Supported numeral systems

• English
  • Standard
  • Fullwidth
  • Subscript
  • Superscript
• Persian
• Hindi
• Arabic-Indic
• Bengali
• Thai
• Khmer
• Burmese
• Tibetan
• Gujarati
• Odia
• Telugu
• Kannada
• Gurmukhi
• Lao

Issues & bug reports

Just fill an issue and describe it. We'll check it ASAP! or send an email to [e-mail].

• Please complete the issue template

You can also join our discord server

Show your support

Star this repo

Give a ⭐️ if this project helped you!

Donate to our project

If you do like our project and we hope that you do, can you please support us? Our project is not and is never going to be working for profit. We need the money just so we can continue doing what we do ;-) .

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.5 - 2025-09-01

Added

• Lao numeral system
• English fullwidth mode
• English subscript mode
• English superscript mode

Changed

• Test system modified
• README.md updated

0.4 - 2025-08-18

Added

• Gurmukhi numeral system
• Kannada numeral system
• Telugu numeral system

Changed

• Test system modified
• README.md updated

0.3 - 2025-08-05

Added

• Tibetan numeral system
• Gujarati numeral system
• Odia numeral system

Changed

• README.md updated

0.2 - 2025-07-28

Added

• Thai numeral system
• Khmer numeral system
• Burmese numeral system
• Logo

Changed

• Test system modified
• target parameter bug fixed
• README.md updated

0.1 - 2025-07-20

Added

• English numeral system
• Persian numeral system
• Hindi numeral system
• Arabic-Indic numeral system
• Bengali numeral system