Humanumbers

Humanumbers is a Python package for turning rigid numeric text into more natural phrasing without losing the meaning of the original value.

Install

pip install humanumbers

Optional MCP support:

pip install "humanumbers[mcp]"

Basic usage

from humanumbers.service import get_service
from humanumbers.api_models import HumanizeRequest

service = get_service("en")
result = service.humanize(
    HumanizeRequest(
        text="The cable is 1245 mm long.",
        source_language="auto",
        output_language="en",
        mode="humanize",
        approximation="normal",
        system_preference="si",
        variants=3,
    )
)

print(result.model_dump())

Included surfaces

• Python module: humanumbers
• CLI entrypoints:
  • humanumbers-api
  • humanumbers-mcp

Requirements

Python 3.12+