g2pkk

What it is and what it does

g2pkk is a Korean grapheme-to-phoneme (g2p) library designed to work reliably across Windows, macOS, and Linux. It adapts Kyubyong's g2pk by swapping out the morpheme analyzer based on the operating system—using eunjeon on Windows (where the original mecab-based g2pk fails to build) and python-mecab-ko on Unix-like systems. The library depends on jamo for Korean character handling and nltk for linguistic processing.

The package is abandoned: its only release (0.1.2) was published on 2022-09-05 and has received no updates since. It carries a Production/Stable classifier but has not been maintained for over three years. It is suitable only for projects that can accept a frozen, unsupported dependency—no bug fixes, security patches, or compatibility updates will be forthcoming.

Use it for:

• Convert Korean text to phonetic representation for text-to-speech synthesis systems that require phoneme input.
• Preprocess Korean text in NLP pipelines where phonetic features or pronunciation variants are needed.
• Build Korean language tools on Windows without dealing with mecab compilation issues.
• Analyze Korean morphology and generate phonetic transcriptions for linguistic research or education.
• Augment Korean datasets with phonetic annotations for machine learning training.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

g2pkk converts Korean text to phonetic representation (grapheme-to-phoneme) with cross-platform support, using platform-specific morpheme analyzers to work reliably on Windows and Unix-like systems.

No, unless you have a specific, locked use case. The package is abandoned (last update 2022-09-05, no commits since), carries minimal maintenance signal (3 repository stars), and offers no path to security updates or compatibility fixes. The low install friction and permissive license do not offset the risk of depending on unmaintained code. Consider forking or switching to an actively maintained Korean g2p alternative.

Install

g2pkk on PyPI

pip install g2pkk

uv add g2pkk

poetry add g2pkk

Installing g2pkk

Before you install

Low friction: pure Python wheel with only two runtime dependencies (jamo, nltk). However, maintenance is abandoned—last release was 2022-09-05 with no updates since, and the repository shows minimal activity (3 stars). Use only if the frozen version meets your needs.

License in practice

Apache License 2.0 (permissive) imposes no significant restrictions on use, modification, or distribution. You may use this in commercial or proprietary projects provided you retain license notices.

Quickstart

pip install g2pkk

from g2pkk import G2p
g2p = G2p()
result = g2p("포상은 열심히 한 아이에게만 주어지기 때문에 포상인 것입니다.")

Requires Python >= 3.6. On Windows, eunjeon (a mecab wrapper) is installed automatically; on other systems, python-mecab-ko is installed. Ensure your system can run the appropriate morpheme analyzer.

Verify before relying

• Whether the automatic morpheme analyzer installation actually succeeds on all Windows versions and configurations.
• Current compatibility with Python versions beyond 3.7 (classifiers list only 3.6 and 3.7, but requires_python says >=3.6).
• Whether jamo and nltk versions have known incompatibilities or security issues that would affect g2pkk users.

Package facts

Evidence: g2pkk-0.1.2-py3-none-any.whl

Tags

More Linguistic packages