vox4ai
Website • Report Bug • Contributing
🚀 Overview
TTS 音声合成 CLI。tts-plugin-bridge のプラグインシステムに対応した TTS Engine を
統一的に操作できます。vox と vox4ai 両方のコマンド名でインストールされます。
📦 Installation
uv add vox4ai
インストールするだけで tts-plugin-bridge + tts-plugin-edgetts(クラウドデフォルト)が
入り、追加のローカルサーバーなしで音声合成を試せます。
他の TTS エンジンを追加する場合:
uv add tts-plugin-aivisspeech # AivisSpeech Engine
uv add tts-plugin-piperplus # Piper Plus (HTTP server)
uv add tts-plugin-voisonatalk # VoiSona Talk
uv add tts-plugin-kokoro # Kokoro (local)
🛠 Usage
vox と vox4ai は同義。短い vox を推奨。
# テキストを読み上げる(デフォルト: edgetts)
vox "こんにちは"
# 音声ファイルに保存
vox save "こんにちは" -o output.wav
# engine を明示指定
vox "こんにちは" -e aivisspeech --style-id 888753760
# 利用可能な TTS エンジン一覧
vox list
# 接続テスト
vox test -e aivisspeech --server-url http://localhost:10101
# 環境診断
vox --doctor
# 現在の設定
vox config
# サブコマンド一覧
vox --commands
⚙️ Configuration
vox4ai say "こんにちは" のように engine を省略しても、設定ファイルからデフォルト値を読み込みます。
場所: ~/.config/vox4ai/config.yaml(XDG_CONFIG_HOME 準拠)
設定例:
# デフォルトの TTS Engine
engine: edgetts
# デフォルトの音声モデル
model: ja-JP-NanamiNeural
# TTS サーバーURL(aivisspeech などで必要)
server_url: http://localhost:10101
# デフォルトの話速(0.5 〜 2.0、デフォルト 1.0)
speed: 1.2
# 話者スタイル ID(aivisspeech など)
style_id: 888753760
優先順位: CLI 引数 > config.yaml > デフォルト値
⌨️ Subcommands
| Command | Description |
|---|---|
say |
テキストを読み上げる(ffplay ストリーミング優先 → paplay/aplay) |
save |
テキストを音声ファイルに保存 |
list |
利用可能なTTSプラグインを一覧表示 |
test |
TTSエンジンへの接続テスト |
config |
現在の設定 (config.yaml) を表示 |
📦 Dependencies
tts-plugin-bridge— コアフレームワークtts-plugin-edgetts— Microsoft Edge TTS(クラウド、デフォルト)vox4ai-skill-lib— 内部ライブラリ- 任意の TTS プラグイン (
tts-plugin-aivisspeech,tts-plugin-piperplusなど)
📜 License
MIT License
Metadata
Release files for vox4ai 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| vox4ai-0.1.0.tar.gz | 132.9 kB | Without provenance | Details for vox4ai-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| vox4ai-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for vox4ai-0.1.0-py3-none-any.whl |
Total release size: 140.1 kB
Release files / vox4ai-0.1.0.tar.gz
| Download URL | vox4ai-0.1.0.tar.gz |
|---|---|
| Size | 132.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
81416607fd72d1242cccf4331bbfcd2afc58a017a936a44f9751a4b50b584c95
|
|
BLAKE2b-256 checksum How to use checksums |
a27acd5bce73a346c249a9a0ba81353d54c1465c52fee22c731f488de5e63738
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Release files / vox4ai-0.1.0-py3-none-any.whl
| Download URL | vox4ai-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
48783989bb1878cb6ef6958b09eeade2889a3a4cf377f87f8a3b937ad6e7d650
|
|
BLAKE2b-256 checksum How to use checksums |
850d6afc7c8b4f7c347fed75dd00786fb88da7dab93e48dba6b6ccfd77e187aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Security for vox4ai 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.