{"id":21774,"library":"pyopenjtalk","title":"pyopenjtalk","description":"A Python wrapper for OpenJTalk, a Japanese text-to-speech engine. Current version 0.4.1, requires Python >=3.8 and cmake. Release cadence is irregular; last release was 2025-03-01.","status":"active","version":"0.4.1","language":"python","source_language":"en","source_url":"https://github.com/r9y9/pyopenjtalk","tags":["japanese","tts","text-to-speech","openjtalk","speech-synthesis"],"install":[{"cmd":"pip install pyopenjtalk","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for building from source (C extension). Install via system package manager if pip fails.","package":"cmake","optional":true},{"reason":"Required for array operations; automatic install, but version must be >=1.20.","package":"numpy","optional":false}],"imports":[{"note":"run_frontend is a top-level function, not part of a submodule.","wrong":"from pyopenjtalk.frontend import run_frontend","symbol":"run_frontend","correct":"from pyopenjtalk import run_frontend"},{"note":"synthesize is a function, not a module.","wrong":"import pyopenjtalk.synthesize","symbol":"synthesize","correct":"from pyopenjtalk import synthesize"}],"quickstart":{"code":"import pyopenjtalk\n\n# Synthesize speech from text (returns wav as numpy array)\ntext = \"こんにちは\"\nwav, sr = pyopenjtalk.synthesize(text)\n\n# Or get linguistic features\nfeatures = pyopenjtalk.run_frontend(text)\nprint(features)","lang":"python","description":"Basic usage: synthesize speech or extract linguistic features from Japanese text."},"warnings":[{"fix":"Check the full documentation for new feature structure; verify your parsing code against output.","message":"In v0.3.0, run_frontend behavior changed due to introduction of 'marine' accent model. Output format may differ from v0.2.x.","severity":"breaking","affected_versions":">=0.3.0"},{"fix":"Ensure cmake is installed and in PATH before 'pip install pyopenjtalk'.","message":"Building from source requires cmake. If pip fails to install, install cmake first (e.g., 'apt install cmake' or 'brew install cmake').","severity":"gotcha","affected_versions":"all"},{"fix":"Replace 'run_tts' with 'synthesize'.","message":"Legacy API functions like 'pyopenjtalk.run_tts' are removed as of v0.3.4. Use 'pyopenjtalk.synthesize' instead.","severity":"deprecated","affected_versions":">=0.3.4"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install pyopenjtalk'. If on Windows, may need to install Visual C++ Build Tools.","cause":"Package not installed or installed incorrectly.","error":"ModuleNotFoundError: No module named 'pyopenjtalk'"},{"fix":"Reinstall: 'pip uninstall pyopenjtalk && pip install pyopenjtalk'. On Linux, ensure build essentials are installed.","cause":"Missing system dependencies or broken installation.","error":"ImportError: libopenjtalk.so: cannot open shared object file"},{"fix":"Upgrade numpy: 'pip install --upgrade numpy' to at least 1.20.","cause":"numpy version mismatch between build and runtime.","error":"ValueError: numpy.ndarray size changed, may indicate binary incompatibility"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}