---
id: roman
version: "5.2"
license: ZPL-2.1
license_treatment: unclear
maintenance: active
---

# roman — Integer to Roman numerals converter

License: unclear · Maintenance: active · Downloads: 1.9M/mo

## What it is and what it does

Roman is a lightweight converter between Arabic integers and Roman numerals. It provides both a Python API (toRoman and fromRoman functions) and a standalone CLI command for bidirectional conversion. The library handles standard Roman numeral notation and supports lowercase variants. It has no runtime dependencies and installs as a pure Python wheel.

The package is production-stable, actively maintained, and supports modern Python versions (3.10 through 3.14). It's useful for applications that need to display or parse Roman numerals—common in historical data, formal documents, or educational contexts. The CLI makes it accessible from shell scripts or manual conversion tasks.

Use it for:

- Convert integers to Roman numerals for display in formal documents or historical applications.
- Parse Roman numeral input from users and convert back to integers for computation.
- Generate Roman numeral sequences for outline numbering, chapter markers, or copyright dates.
- Batch-convert large sets of numbers via the command-line interface in scripts or pipelines.
- Embed numeral conversion in educational software or tools that teach Roman numeral systems.

## Worth the install?

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

Converts between Arabic integers and Roman numerals in both directions, with a command-line interface and Python API.

Yes. Roman is a stable, zero-dependency utility with active maintenance and no known vulnerabilities. Install it if you need bidirectional Roman numeral conversion. The only caveat is the unclear license treatment—verify ZPL-2.1 compatibility with your project's licensing constraints before use.

## Install

pip install roman
uv add roman
poetry add roman

## Installing roman

Before you install: Low friction installation with no runtime dependencies. Actively maintained with recent releases; last commit 2026-03-02 and version 5.2 released 2025-11-11. Supports current Python versions (3.10+) and drops older versions regularly.

License in practice: Licensed under Zope Public License (ZPL-2.1), classified as OSI-approved. License treatment is marked unclear in the metadata, so you may want to review the actual license terms before use in proprietary or restricted contexts.

Quickstart:

import roman

# Convert integer to Roman numeral
print(roman.toRoman(10))  # X

# Convert Roman numeral to integer
print(roman.fromRoman('X'))  # 10

# Command line: roman 972 → CMLXXII

Requires Python 3.10 or later.

Verify before relying:

- Whether the unclear license treatment affects your intended use case—review ZPL-2.1 terms directly.
- Whether lowercase Roman numeral support (added in 5.0) meets your formatting requirements.

## Package facts

- License: ZPL-2.1 (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

roman numeral converter, arabic to roman numerals, integer to roman conversion, roman numeral library, convert numbers to roman, roman numeral cli, number-formatting, cli-tool

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