{"library":"pypinyin","title":"Chinese Pinyin Conversion (pypinyin)","description":"pypinyin is a Python library for converting Chinese characters to Pinyin. It intelligently matches the most fitting Pinyin based on phrase occurrences, supports heteronyms (multi-pronunciation characters), simplified/traditional Chinese, Zhuyin, and various Pinyin styles (e.g., tone conventions). The library is actively maintained, with version 0.55.0 released recently, demonstrating a consistent release cadence.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install pypinyin"],"cli":null},"imports":["from pypinyin import pinyin","from pypinyin import lazy_pinyin","from pypinyin import Style"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from pypinyin import pinyin, lazy_pinyin, Style\n\nchinese_text = \"你好，世界！\"\n\n# Convert to Pinyin with tone marks (default style)\npinyin_result_toned = pinyin(chinese_text)\nprint(f\"Toned Pinyin: {pinyin_result_toned}\")\n\n# Convert to Pinyin without tone marks (lazy_pinyin)\npinyin_result_lazy = lazy_pinyin(chinese_text)\nprint(f\"Lazy Pinyin: {pinyin_result_lazy}\")\n\n# Convert to Pinyin using first letter style\npinyin_result_first_letter = pinyin(chinese_text, style=Style.FIRST_LETTER)\nprint(f\"First Letter Pinyin: {pinyin_result_first_letter}\")\n\n# Handle heteronyms (multi-pronunciation characters)\nheteronym_text = \"中心\"\npinyin_heteronym = pinyin(heteronym_text, heteronym=True)\nprint(f\"Heteronym Pinyin for '中心': {pinyin_heteronym}\")\n","lang":"python","description":"Demonstrates basic conversion of Chinese characters to Pinyin using `pinyin` and `lazy_pinyin` functions, including handling different styles and heteronyms.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"0.55.0","pypi_latest":"0.55.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.6,"avg_import_s":0.6,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.56,"mem_mb":52.5,"disk_size":"21.6M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.43,"mem_mb":52.5,"disk_size":"22M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.71,"mem_mb":51.2,"disk_size":"23.5M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.64,"mem_mb":51.4,"disk_size":"24M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.64,"mem_mb":47.1,"disk_size":"15.4M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.69,"mem_mb":47.1,"disk_size":"16M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.57,"mem_mb":47.3,"disk_size":"15.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.6,"mem_mb":47.1,"disk_size":"16M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.6,"mem_mb":52.5,"disk_size":"21.1M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pypinyin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.8,"import_time_s":0.52,"mem_mb":52.5,"disk_size":"22M"}]}}