🦭 SEA-G2P

Fast multilingual text-to-phoneme converter for South East Asian languages.

Author: Pham Nguyen Ngoc Bao

🚀 Used By

SEA-G2P is the core phonemization engine powering:

VieNeu-TTS: An advanced on-device Vietnamese Text-to-Speech model with instant voice cloning.

By using SEA-G2P, VieNeu-TTS achieves high-fidelity pronunciation and seamless Vietnamese-English code-switching.

Installation

pip install sea-g2p

Usage

Simple Pipeline

from sea_g2p import SEAPipeline

pipeline = SEAPipeline(lang="vi")

# Single text
result = pipeline.run("Giá SP500 hôm nay là 4.200,5 điểm.")
print(result)
#zˈaːɜ ˈɛɜt̪ pˈe nˈam tʃˈam hˈom nˈaj lˌaː2 bˈoɜn ŋˈi2n hˈaːj tʃˈam fˈəɪ4 nˈam ɗˈiɛ4m.

# Batch processing (Parallel)
texts = ["Giá cổ phiếu tăng từ $0.000045 lên $1,234.5678 trong 3.5×10^6 giao dịch.", "Hãy gửi email đến support@example.com."] * 1000
results = pipeline.run(texts)

Individual Modules

from sea_g2p import Normalizer, G2P

normalizer = Normalizer(lang="vi")
g2p = G2P(lang="vi")

# Automatic parallel processing when list is passed
texts = ["Giá cổ phiếu tăng từ $0.000045 lên $1,234.5678 trong 3.5×10^6 giao dịch.", "Hãy gửi email đến support@example.com."]
normalized = normalizer.normalize(texts)
print(normalized)
#['giá cổ phiếu tăng từ không chấm không không không không bốn lăm <en>u s d</en> lên một nghìn hai trăm ba mươi bốn phẩy năm sáu bảy tám <en>u s d</en> trong ba chấm năm nhân mười mũ sáu giao dịch.', 'hãy gửi email đến <en>support</en> a còng <en>example</en> chấm com.']
phonemes = g2p.convert(normalized)
print(phonemes)
#['zˈaːɜ kˈo4 fˈiɛɜw t̪ˈaŋ t̪ˌy2 xˌoŋ tʃˈəɜm xˌoŋ xˌoŋ xˌoŋ xˌoŋ bˈoɜn lˈam jˈuː ˈɛs dˈiː lˈen mˈo6t̪ ŋˈi2n hˈaːj tʃˈam bˈaː mˈyəj bˈoɜn fˈəɪ4 nˈam sˈaɜw bˈa4j t̪ˈaːɜm jˈuː ˈɛs dˈiː tʃˈɔŋ bˈaː tʃˈəɜm nˈam ɲˈən mˈyə2j mˈu5 sˈaɜw zˈaːw zˈi6c.', 'hˈa5j ɣˈy4j ˈiːmeɪl ɗˌeɜn səpˈɔːɹt ˈaː kˈɔ2ŋ ɛɡzˈæmpəl tʃˈəɜm kˈɔm.']

Features

Blazing Fast: Core engine rewritten in Rust with binary mmap lookup.
Multithreading: Automatic parallel processing using Rayon/Rust for batch inputs.
Zero Dependency: Pre-compiled wheels for Windows, Linux, and macOS.
Smart Normalization: Specialized for Vietnamese (numbers, dates, technical terms).
Bilingual Support: Handles mixed Vietnamese/English text seamlessly.
Markup tags: Wrap a span to control reading:
- <en>...</en> — keep the content for the English phonemizer (e.g. <en>hello</en>).
- <math>...</math> — read as a math formula: variable clusters are spelled letter-by-letter and operators/symbols are voiced, while function names (sin, cos, log, lim, ...) are preserved. <math>b² - 4ac</math> → "bê bình phương trừ bốn a xê", <math>∫f dx</math> → "tích phân ép đê ích".

📊 Performance

The following benchmarks were conducted on a dataset of 1,000,000 sentences:

Module	Implementation	Throughput
Normalizer	Rust Core (Parallel)	~41,000 sentences/s
G2P	Rust Core (Parallel)	~415,000 sentences/s

Total Pipeline Throughput: ~37,000 sentences/s (Tested on CPython 3.12, Windows 11, Multithreaded)

Technical Architecture

SEA-G2P is designed for maximum performance in production environments:

Memory Mapping (mmap): Instead of loading a huge JSON/SQLite into RAM, we use a custom binary format (.bin) mapped directly into memory. This allows near-instant startup and extremely low memory overhead.
String Pooling: To minimize file size, all unique strings (words and phonemes) are stored once in a global string pool and referenced by 4-byte IDs.
Binary Search: Words are pre-sorted during the build process, allowing O(log n) lookup speeds directly on the memory-mapped data.

For full details on the specification, see src/g2p/mod.rs.

Development

To install for development purposes:

Clone the repository:

git clone https://github.com/pnnbao97/sea-g2p
cd sea-g2p

Install in editable mode:
```
pip install -e .
```

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sea_g2p-0.7.17.tar.gz (20.1 MB view details)

Uploaded Jul 3, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sea_g2p-0.7.17-cp310-abi3-win_amd64.whl (21.2 MB view details)

Uploaded Jul 3, 2026 CPython 3.10+Windows x86-64

sea_g2p-0.7.17-cp310-abi3-win32.whl (21.1 MB view details)

Uploaded Jul 3, 2026 CPython 3.10+Windows x86

sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (21.5 MB view details)

Uploaded Jul 3, 2026 CPython 3.10+manylinux: glibc 2.17+ x86-64

sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (21.5 MB view details)

Uploaded Jul 3, 2026 CPython 3.10+manylinux: glibc 2.17+ ARM64

sea_g2p-0.7.17-cp310-abi3-macosx_11_0_arm64.whl (21.3 MB view details)

Uploaded Jul 3, 2026 CPython 3.10+macOS 11.0+ ARM64

sea_g2p-0.7.17-cp310-abi3-macosx_10_12_x86_64.whl (21.4 MB view details)

Uploaded Jul 3, 2026 CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file sea_g2p-0.7.17.tar.gz.

File metadata

Download URL: sea_g2p-0.7.17.tar.gz
Upload date: Jul 3, 2026
Size: 20.1 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17.tar.gz
Algorithm	Hash digest
SHA256	`505306a12ac237a7e6a1b073e83872824d78444ed9f3e84b566c86062c3ca1c0`
MD5	`7c25c15044dd5aefacff0c82bd96c3ac`
BLAKE2b-256	`03a3561f44f9c37d39f93e45e10a68aa11ec55f92a3e55f7890b15a6d735a6d0`

See more details on using hashes here.

File details

Details for the file sea_g2p-0.7.17-cp310-abi3-win_amd64.whl.

File metadata

Download URL: sea_g2p-0.7.17-cp310-abi3-win_amd64.whl
Upload date: Jul 3, 2026
Size: 21.2 MB
Tags: CPython 3.10+, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17-cp310-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`faec93cf8976b510c6f7cb54a9aee4e2f6d31765778d3db4820ab9af60338554`
MD5	`4154077ba555dcb804881c050165c70e`
BLAKE2b-256	`4669e95fae3e51a6ac17dc7f5851665940187f1cf09a68219e8a55540424a1d9`

See more details on using hashes here.

File details

Details for the file sea_g2p-0.7.17-cp310-abi3-win32.whl.

File metadata

Download URL: sea_g2p-0.7.17-cp310-abi3-win32.whl
Upload date: Jul 3, 2026
Size: 21.1 MB
Tags: CPython 3.10+, Windows x86
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17-cp310-abi3-win32.whl
Algorithm	Hash digest
SHA256	`1b44d98d10a92c4f68ba81ea0702b2da0a070250c08d89b052ba0ed668402b6b`
MD5	`f8b016e52c2728e78d096c541f057ccd`
BLAKE2b-256	`d7bd9c2d0983c71c71c84046599598db3ea55f972fa48480e798a982b17e1110`

See more details on using hashes here.

File details

Details for the file sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 3, 2026
Size: 21.5 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`a178a35ab724f3ab76bd7af521735287d1a354af356d379ba0054f6e0f318ee8`
MD5	`900e09934b152d986eb843e944cba814`
BLAKE2b-256	`68303d75ff707bc4e63ff3809ddcde07602e047adf7434e2c72a4178bf875cdd`

See more details on using hashes here.

File details

Details for the file sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 3, 2026
Size: 21.5 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`d4755b2f736443336d916ec971963edb1a7b4ddac68cb2dc61b9ff4fa95951c2`
MD5	`a901e04a549cca2edc29cc0bce46c179`
BLAKE2b-256	`a3e45d1dd1acb1c1ec4f9b1f610716df5e267d57bc5e9459ef35e3f6f7893f8b`

See more details on using hashes here.

File details

Details for the file sea_g2p-0.7.17-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: sea_g2p-0.7.17-cp310-abi3-macosx_11_0_arm64.whl
Upload date: Jul 3, 2026
Size: 21.3 MB
Tags: CPython 3.10+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17-cp310-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`45c5af71d2009176c93c56541d2789aa9cb4de93c500614171c5c7b999413293`
MD5	`7bf58f48f75407abf5c23ccead538e17`
BLAKE2b-256	`819e1643a02012724fd71c365582041baffbdd2bf22411f2444ca4edaa516fa4`

See more details on using hashes here.

File details

Details for the file sea_g2p-0.7.17-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: sea_g2p-0.7.17-cp310-abi3-macosx_10_12_x86_64.whl
Upload date: Jul 3, 2026
Size: 21.4 MB
Tags: CPython 3.10+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for sea_g2p-0.7.17-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`68d4122cf161febf21077fa14f86410e4073706007bf583a3be4b06114920c54`
MD5	`fadaf1441b5674c85c4c8f7be924b35b`
BLAKE2b-256	`c022c468ca26a7f9c900fad25d789288e4ace8e9d436521f2809f122df9201d7`