pypinyin

Health v2 · maintenance only

Adoption not part of the score

5356 stars · 627 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

pypinyin is a Python library (with a companion CLI) that converts Chinese characters (hanzi) to pinyin, supporting polyphonic characters, multiple pinyin styles, bopomofo, and Wade-Giles romanization. It also has related Go and data projects under the same author.

Use cases

• convert chinese characters to pinyin
• get pinyin annotations for hanzi text
• sort chinese strings alphabetically by pinyin
• build chinese text search with pinyin matching
• handle polyphonic characters correctly
• convert pinyin with tone numbers to tone marks
• get first letters of chinese words for indexing

When to choose

• you need accurate hanzi-to-pinyin conversion in Python or Go
• you need polyphone/heteronym support or custom pinyin dictionaries
• you need multiple romanization styles including bopomofo and Wade-Giles

When to avoid

• you need Chinese word segmentation or full NLP pipelines rather than pinyin conversion
• you need machine translation or speech synthesis
• you work in a language ecosystem without a pypinyin port

Facets

library · maturity stable

nlp cli parser developer-tools python cli cross-platform pinyin chinese hanzi text-processing transliteration natural-language-processing localization

Member repositories

For agents

markdown · JSON · MCP: product_card(name="mozillazg/python-pinyin")