Metadata-Version: 2.4
Name: humanumbers
Version: 0.1.0
Summary: Prototype numeric humanization API built on normalized assets
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.115.12
Requires-Dist: uvicorn>=0.34.2
Requires-Dist: pydantic>=2.11.3
Requires-Dist: PyYAML>=6.0.2
Requires-Dist: rapidfuzz>=3.13.0
Requires-Dist: num2words>=0.5.14
Requires-Dist: orjson>=3.10.16
Requires-Dist: pymorphy3>=2.0.3
Requires-Dist: pymorphy3-dicts-ru>=2.4.417150.4580142
Provides-Extra: en
Requires-Dist: inflect>=7.5.0; extra == "en"
Provides-Extra: zh
Requires-Dist: jieba>=0.42.1; extra == "zh"
Requires-Dist: opencc-python-reimplemented>=0.1.7; extra == "zh"
Provides-Extra: ar
Requires-Dist: camel-tools>=1.5.7; extra == "ar"
Provides-Extra: hi
Requires-Dist: indic-nlp-library>=0.92; extra == "hi"
Provides-Extra: bn
Requires-Dist: indic-nlp-library>=0.92; extra == "bn"
Provides-Extra: ur
Requires-Dist: urduhack>=1.1.1; extra == "ur"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Provides-Extra: demo
Requires-Dist: openai>=1.76.0; extra == "demo"
Requires-Dist: mcp>=1.0.0; extra == "demo"
Provides-Extra: dev
Requires-Dist: httpx>=0.28.1; extra == "dev"
Dynamic: license-file

# Humanumbers

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

## Install

```bash
pip install humanumbers
```

Optional MCP support:

```bash
pip install "humanumbers[mcp]"
```

## Basic usage

```python
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+
