lemon-pyopenjtalk-prebuilt

언어 / Language: 한국어 | English | 日本語 | 中文

pyopenjtalk의 사전 빌드(prebuilt) 바이너리 wheel 패키지입니다. pyopenjtalk는 일본어 TTS 엔진 OpenJTalk의 Python 래퍼입니다.

원본 pyopenjtalk는 설치 시 CMake, C++ 컴파일러, Cython 등 빌드 도구가 필요합니다. 이 패키지는 사전 빌드된 wheel을 제공하여 별도의 빌드 도구 없이 바로 설치할 수 있으며, Python 3.9 이상의 최신 버전을 지원합니다.

설치

pip install lemon-pyopenjtalk-prebuilt

사용법

pyopenjtalk와 완전히 동일한 API를 제공합니다 — 모듈명은 그대로 pyopenjtalk입니다:

import pyopenjtalk
from scipy.io import wavfile
import numpy as np

# TTS (텍스트 → 음성)
x, sr = pyopenjtalk.tts("おめでとうございます")
wavfile.write("output.wav", sr, x.astype(np.int16))

# G2P (Grapheme-to-Phoneme, 발음 변환)
pyopenjtalk.g2p("こんにちは")           # → 'k o N n i ch i w a'
pyopenjtalk.g2p("こんにちは", kana=True) # → 'コンニチワ'

더 자세한 사용법은 원본 pyopenjtalk README를 참고하세요.

지원 플랫폼

새로운 Python 버전은 매월 자동으로 감지되어 PR로 추가됩니다.

CI/CD 워크플로우

Build and Release Wheels (build_and_release.yml)

버전 태그(v*) 푸시 또는 수동 실행 시 동작합니다.

빌드 환경:

Check for new Python versions (check_new_python.yml)

매월 1일 자동 실행되며, 수동 실행도 가능합니다.

endoflife.date에서 현재 지원 중인 Python 버전을 조회하여, pyproject.toml의 빌드 대상에 빠진 버전이 있으면 자동으로 PR을 생성합니다.

만든 이유

• pyopenjtalk — 사전 빌드 wheel 없음 (소스 빌드만 지원)
• pyopenjtalk-prebuilt — Python 3.11에서 업데이트 중단
• 이 패키지는 Python 3.9 이상을 대상으로 사전 빌드 wheel을 제공하고, 월간 자동 버전 체크로 최신 Python을 지속 지원합니다.

라이선스

• lemon-pyopenjtalk-prebuilt: MIT License
• pyopenjtalk: MIT License (LICENSE.md) — © Ryuichi Yamamoto
• Open JTalk: Modified BSD License (COPYING)
• hts_engine_API: Modified BSD License
• marine (선택): Apache 2.0 License

포함된 일본어 사전

본 패키지는 OpenJTalk 일본어 사전(open_jtalk_dic_utf_8-1.11)을 포함하여 배포됩니다. 해당 사전은 다음 3개 라이선스(모두 Modified BSD 계열)를 따르며, 전체 라이선스 조항은 설치된 wheel의 pyopenjtalk/open_jtalk_dic_utf_8-1.11/COPYING 파일에서 확인할 수 있습니다.

• © 2009, Nara Institute of Science and Technology (NAIST)
• © 2011–2017, The UniDic Consortium
• © 2008–2016, Nagoya Institute of Technology — HTS Working Group

감사의 말

핵심 라이브러리의 모든 공로는 r9y9와 HTS Working Group에 있습니다. 이 저장소는 원본 pyopenjtalk 위에 사전 빌드 wheel 배포 기능만 추가한 것입니다.