---
id: roman-numerals-py
version: "4.1.0"
license: 0BSD OR CC0-1.0
license_treatment: permissive
maintenance: active
---

# roman-numerals-py — This package is deprecated, switch to roman-numerals.

License: permissive · Maintenance: active · Downloads: 2.5M/mo

## What it is and what it does

roman-numerals-py is a utility for bidirectional conversion between integers and Roman numerals. It lets you create a RomanNumeral object from an integer (e.g., 16 becomes 'XVI') and parse Roman numeral strings back into comparable objects. The package is a pure Python implementation with no compiled dependencies, making it straightforward to install and use.

However, the package summary explicitly states it is deprecated and recommends switching to roman-numerals instead. This means you should treat it as a legacy option; if you are starting a new project, the maintainers suggest using the replacement package. For existing code or specific compatibility needs, it remains functional and actively maintained, but migration is encouraged.

Use it for:

- Convert integers to Roman numeral strings for display in historical or formal documents.
- Parse user-supplied Roman numeral input and validate or compare it against numeric values.
- Generate Roman numerals for outline numbering, clock faces, or other traditional formatting.
- Educational projects teaching numeral systems or number representation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts between integers and Roman numerals, parsing strings like 'XVI' to numbers and vice versa.

No—the package is explicitly deprecated. The maintainers recommend switching to roman-numerals instead. Install only if you are maintaining legacy code that already depends on roman-numerals-py; for new projects, use the recommended replacement.

## Install

pip install roman-numerals-py
uv add roman-numerals-py
poetry add roman-numerals-py

## Installing roman-numerals-py

Before you install: Low friction installation as a pure Python wheel. Active maintenance with recent releases, though the package summary notes it is deprecated in favor of roman-numerals.

License in practice: Dual-licensed under 0BSD or CC0-1.0, both permissive; you may use, modify, and distribute freely with minimal restrictions.

Quickstart:

pip install roman-numerals-py

from roman_numerals import RomanNumeral

num = RomanNumeral(16)
print(num)  # XVI
assert RomanNumeral.from_string("XVI") == num

Requires Python 3.10 or later.

Verify before relying:

- Whether roman-numerals (the recommended replacement) offers materially different or improved functionality.
- Whether the deprecation notice means this package will stop receiving updates or support.

## Package facts

- License: 0BSD OR CC0-1.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

roman numeral conversion, integer to roman numeral, parse roman numerals, XVI to number, numeral formatter, deprecated, numeral-conversion

[View on SkillFed](https://skillfed.io/packages/roman-numerals-py) · [View on PyPI](https://pypi.org/project/roman-numerals-py/)