Install & Compatibility
Where this runs
tested against v? · pip install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
run_frontend
✓ from pyopenjtalk import run_frontend
✗ from pyopenjtalk.frontend import run_frontend
run_frontend is a top-level function, not part of a submodule.
synthesize
✓ from pyopenjtalk import synthesize
✗ import pyopenjtalk.synthesize
synthesize is a function, not a module.
Basic usage: synthesize speech or extract linguistic features from Japanese text.
import pyopenjtalk
# Synthesize speech from text (returns wav as numpy array)
text = "こんにちは"
wav, sr = pyopenjtalk.synthesize(text)
# Or get linguistic features
features = pyopenjtalk.run_frontend(text)
print(features)
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'pyopenjtalk'
Package not installed or installed incorrectly.
fixRun 'pip install pyopenjtalk'. If on Windows, may need to install Visual C++ Build Tools.
ImportError: libopenjtalk.so: cannot open shared object file
Missing system dependencies or broken installation.
fixReinstall: 'pip uninstall pyopenjtalk && pip install pyopenjtalk'. On Linux, ensure build essentials are installed.
ValueError: numpy.ndarray size changed, may indicate binary incompatibility
numpy version mismatch between build and runtime.
fixUpgrade numpy: 'pip install --upgrade numpy' to at least 1.20.
Upgrade
Version history
0.4.1latest on PyPI · released Apr 8, 2025
Audit
Dependencies
cmakeoptionalRequired for building from source (C extension). Install via system package manager if pip fails.
numpyrequiredRequired for array operations; automatic install, but version must be >=1.20.