Metadata-Version: 2.4
Name: brighto-norm4tts
Version: 1.0.0
Summary: Production multilingual TTS text normalizer — vi, en, zh, ja, ko, fr, de
Author-email: BrighTO Technology <ai@brightotechnology.com>
License: Proprietary
Project-URL: Homepage, https://brightotechnology.com
Keywords: tts,text-normalization,nlp,speech,vietnamese,multilingual
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-benchmark; extra == "dev"

# brighto-norm4tts

**Production multilingual TTS text normalizer** by BrighTO Technology / HATTO AI.

Converts written text → spoken form for TTS pipelines.  
Pure Python · Zero dependencies · < 1ms per sentence.

## Languages

| Code | Language   | Decimal sep | Thousand sep |
|------|-----------|-------------|--------------|
| `vi` | Vietnamese | `,` phẩy    | `.`          |
| `en` | English    | `.` point   | `,`          |
| `zh` | Chinese    | `.` 点      | `,`          |
| `ja` | Japanese   | `.` 点      | `,`          |
| `ko` | Korean     | `.` 점      | `,`          |
| `fr` | French     | `,` virgule | `.` or ` `   |
| `de` | German     | `,` Komma   | `.`          |

## Install

```bash
pip install brighto-norm4tts          # from PyPI / private registry
pip install .                          # from source
pip install -e .                       # dev editable
```

## Usage

```python
from brighto_norm4tts import TTSNormalizer

norm = TTSNormalizer("vi")
norm.normalize("năm 2026 tăng 15.4%")
# → năm hai nghìn hai mươi sáu tăng mười lăm phẩy bốn phần trăm

# Wildcard import also works
from brighto_norm4tts import *
norm = TTSNormalizer("en")
norm.normalize("Revenue $1.5M, up 12.3%", lower=False, punc=False)
# → Revenue one point five million dollars, up twelve point three percent
```

## API

```python
TTSNormalizer(lang)                               # lang: vi|en|zh|ja|ko|fr|de
    .normalize(text, lower=False, punc=True)      # main method
    .benchmark(sentences, num_runs=100)           # latency profiling
```

## CLI

```bash
brighto-norm --lang vi --text "năm 2026 tăng 15.4%"
brighto-norm --lang vi --demo
brighto-norm --lang en --benchmark
```

## Private PyPI deployment

```bash
# Build
pip install build && python -m build

# Upload to internal registry
twine upload --repository-url https://pypi.internal.brightotechnology.com dist/*

# Install on any server
pip install brighto-norm4tts --index-url https://pypi.internal.brightotechnology.com
```

---
© BrighTO Technology. All rights reserved.
