vox4ai 0.1.0__tar.gz

vox4ai-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+venv/
+ENV/
+.idea/
+.vscode/
+build/
+dist/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.log
+.env
+.env.local
+
+# Generated
+.coverage
+GEMINI.md
+*.bak
+.mutmut-tmp.toml

vox4ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vox4ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vox4ai-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: vox4ai
+Version: 0.1.0
+Summary: TTS 音声合成 CLI - vox / vox4ai コマンド
+Project-URL: Homepage, https://github.com/vox4ai/vox4ai
+Project-URL: Repository, https://github.com/vox4ai/vox4ai
+Project-URL: Issues, https://github.com/vox4ai/vox4ai/issues
+Author-email: utenadev <utena.cross+pypi@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,edgetts,speech,synthesis,tts,tts-plugin-bridge,voice,vox4ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: pydantic-settings>=2.14.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tts-plugin-bridge
+Requires-Dist: tts-plugin-edgetts
+Requires-Dist: vox4ai-skill-lib
+Description-Content-Type: text/markdown
+
+# vox4ai
+
+<p align="center">
+  <img src="https://via.placeholder.com/1200x400/1a1a1a/ffffff?text=vox4ai" alt="vox4ai Banner" width="1200">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pypi-latest-blue.svg" alt="PyPI version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/python-3.10%2B-yellow.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/maintained%3F-yes-brightgreen.svg" alt="Maintained">
+</p>
+
+<p align="center">
+  <a href="https://github.com/vox4ai/vox4ai">Website</a> •
+  <a href="https://github.com/vox4ai/vox4ai/issues">Report Bug</a> •
+  <a href="https://github.com/vox4ai/vox4ai/contributing">Contributing</a>
+</p>
+
+---
+
+## 🚀 Overview
+
+TTS 音声合成 CLI。`tts-plugin-bridge` のプラグインシステムに対応した TTS Engine を
+統一的に操作できます。`vox` と `vox4ai` 両方のコマンド名でインストールされます。
+
+## 📦 Installation
+
+```bash
+uv add vox4ai
+```
+
+インストールするだけで `tts-plugin-bridge` + `tts-plugin-edgetts`（クラウドデフォルト）が
+入り、追加のローカルサーバーなしで音声合成を試せます。
+
+他の TTS エンジンを追加する場合：
+
+```bash
+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` を推奨。
+
+```bash
+# テキストを読み上げる（デフォルト: 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 準拠）
+
+**設定例**:
+
+```yaml
+# デフォルトの 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

vox4ai-0.1.0/README.md

@@ -0,0 +1,121 @@
+# vox4ai
+
+<p align="center">
+  <img src="https://via.placeholder.com/1200x400/1a1a1a/ffffff?text=vox4ai" alt="vox4ai Banner" width="1200">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pypi-latest-blue.svg" alt="PyPI version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/python-3.10%2B-yellow.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/maintained%3F-yes-brightgreen.svg" alt="Maintained">
+</p>
+
+<p align="center">
+  <a href="https://github.com/vox4ai/vox4ai">Website</a> •
+  <a href="https://github.com/vox4ai/vox4ai/issues">Report Bug</a> •
+  <a href="https://github.com/vox4ai/vox4ai/contributing">Contributing</a>
+</p>
+
+---
+
+## 🚀 Overview
+
+TTS 音声合成 CLI。`tts-plugin-bridge` のプラグインシステムに対応した TTS Engine を
+統一的に操作できます。`vox` と `vox4ai` 両方のコマンド名でインストールされます。
+
+## 📦 Installation
+
+```bash
+uv add vox4ai
+```
+
+インストールするだけで `tts-plugin-bridge` + `tts-plugin-edgetts`（クラウドデフォルト）が
+入り、追加のローカルサーバーなしで音声合成を試せます。
+
+他の TTS エンジンを追加する場合：
+
+```bash
+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` を推奨。
+
+```bash
+# テキストを読み上げる（デフォルト: 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 準拠）
+
+**設定例**:
+
+```yaml
+# デフォルトの 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

vox4ai-0.1.0/pyproject.toml

@@ -0,0 +1,75 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vox4ai"
+version = "0.1.0"
+description = "TTS 音声合成 CLI - vox / vox4ai コマンド"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "utenadev", email = "utena.cross+pypi@gmail.com"},
+]
+keywords = ["tts", "tts-plugin-bridge", "edgetts", "voice", "speech", "synthesis", "cli", "vox4ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "tts-plugin-bridge",
+    "tts-plugin-edgetts",
+    "vox4ai-skill-lib",
+    "pyyaml>=6.0",
+    "pydantic-settings>=2.14.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/vox4ai/vox4ai"
+Repository = "https://github.com/vox4ai/vox4ai"
+Issues = "https://github.com/vox4ai/vox4ai/issues"
+
+[project.scripts]
+vox = "vox4ai.cli:main"
+vox4ai = "vox4ai.cli:main"
+
+[tool.uv.sources]
+tts-plugin-bridge = { path = "../tts-plugin-bridge", editable = true }
+tts-plugin-edgetts = { path = "../tts-plugin-edgetts", editable = true }
+vox4ai-skill-lib = { path = "../vox4ai-skill-lib", editable = true }
+
+[dependency-groups]
+dev = [
+    "build>=1.5.0",
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.15.12",
+    "twine>=6.2.0",
+]
+
+[tool.coverage.run]
+source = ["vox4ai"]
+branch = true
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 50
+
+[tool.mutmut]
+paths_to_mutate = ["src/vox4ai/config.py"]
+tests_dir = ["tests/test_config.py"]
+backup = false

vox4ai-0.1.0/src/vox4ai/cli.py

@@ -0,0 +1,229 @@
+import argparse
+import asyncio
+import shutil
+
+from tts_plugin_bridge import ConnectorFactory
+from vox4ai_skill_lib.api import (
+    list_engines,
+    synthesize_text,
+    play_text,
+    test_connection,
+)
+
+from vox4ai.config import load as load_config, merge_cli, show as show_config
+
+_EPILOG = """
+使用例:
+  vox4ai say "こんにちは"                  # テキストを読む（ストリーミング優先）
+  vox4ai say "Hello" -e edgetts           # Edge TTS で読む
+  vox4ai save "こんにちは" -o output.wav   # WAV ファイルに保存
+  vox4ai list                              # 利用可能エンジン一覧
+  vox4ai test -e aivisspeech              # 接続テスト
+  vox4ai --commands                        # 使用可能なサブコマンド & エンジン一覧
+  vox4ai --doctor                          # 環境診断
+"""
+
+_COMMANDS = {
+    "say": "テキストを読み上げる（ストリーミング優先、ffplay/paplay/aplay）",
+    "save": "テキストを音声ファイルに保存",
+    "list": "利用可能なTTSプラグインを一覧表示",
+    "test": "TTSエンジンへの接続をテスト",
+    "config": "現在の設定（config.yaml）を表示",
+}
+
+
+def main():
+    return asyncio.run(_async_main())
+
+
+async def _async_main():
+    parser = argparse.ArgumentParser(
+        description="vox4ai - 音声合成 CLI",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=_EPILOG,
+        add_help=False,
+    )
+    parser.add_argument(
+        "--commands",
+        action="store_true",
+        help="利用可能なサブコマンド & TTSエンジン一覧を表示",
+    )
+    parser.add_argument(
+        "--doctor",
+        action="store_true",
+        help="環境の動作確認",
+    )
+    parser.add_argument(
+        "-h",
+        "--help",
+        action="store_true",
+        help="このヘルプを表示",
+    )
+    parser.add_argument(
+        "--tts-plugin-list",
+        action="store_true",
+        help=argparse.SUPPRESS,
+    )
+
+    known, remaining = parser.parse_known_args()
+
+    if known.help:
+        parser.print_help()
+        return 0
+
+    if known.commands:
+        print("利用可能なサブコマンド:")
+        for name, desc in _COMMANDS.items():
+            print(f"  {name:8s}  {desc}")
+        print()
+        print("TTS エンジン:")
+        engines = ConnectorFactory.list_available()
+        if engines:
+            for eng in engines:
+                print(f"  {eng}")
+        else:
+            print("  (none found)")
+        print()
+        print("詳細: vox4ai <コマンド> --help")
+        return 0
+
+    if known.doctor:
+        return await _doctor()
+
+    if known.tts_plugin_list:
+        return await list_engines()
+
+    sub = parser.add_subparsers(dest="command", help="利用可能なコマンド")
+    sub.add_parser("list", help="利用可能なTTSプラグインを一覧表示")
+    sub.add_parser("config", help="現在の設定表示")
+
+    say_parser = sub.add_parser(
+        "say", help="テキストを読み上げる（ストリーミング優先）"
+    )
+    say_parser.add_argument("text", help="読み上げるテキスト")
+    say_parser.add_argument("--engine", "-e", help="TTSエンジン名")
+    say_parser.add_argument("--speed", "-s", type=float, default=1.0, help="話速")
+    say_parser.add_argument("--volume", "-v", type=float, help="音量")
+    say_parser.add_argument("--pitch", "-p", type=float, help="ピッチ補正")
+    say_parser.add_argument("--server-url", help="TTSサーバーURL")
+    say_parser.add_argument("--style-id", type=int, help="話者スタイルID")
+    say_parser.add_argument("--model", help="音声モデル名")
+
+    save_parser = sub.add_parser("save", help="テキストを音声ファイルに保存")
+    save_parser.add_argument("text", help="合成するテキスト")
+    save_parser.add_argument("--engine", "-e", help="TTSエンジン名")
+    save_parser.add_argument("--speed", "-s", type=float, default=1.0, help="話速")
+    save_parser.add_argument("--volume", "-v", type=float, help="音量")
+    save_parser.add_argument("--pitch", "-p", type=float, help="ピッチ補正")
+    save_parser.add_argument("--server-url", help="TTSサーバーURL")
+    save_parser.add_argument("--style-id", type=int, help="話者スタイルID")
+    save_parser.add_argument(
+        "--output", "-o", help="出力ファイルパス（省略時はBase64表示）"
+    )
+    save_parser.add_argument("--play", action="store_true", help="保存後に再生")
+
+    test_parser = sub.add_parser("test", help="TTS接続をテスト")
+    test_parser.add_argument("--engine", "-e", help="TTSエンジン名")
+    test_parser.add_argument("--server-url", help="TTSサーバーURL")
+    test_parser.add_argument("--style-id", type=int, help="話者スタイルID")
+
+    args = parser.parse_args(remaining)
+
+    if not args.command:
+        parser.print_help()
+        return 1
+
+    if args.command == "config":
+        print(show_config())
+        return 0
+
+    cfg = load_config()
+    if args.command in ("say", "save", "test"):
+        merged = merge_cli(cfg, args)
+    else:
+        merged = {}
+
+    engine_kwargs = {}
+    if merged.get("server_url"):
+        engine_kwargs["server_url"] = merged["server_url"]
+
+    engine = merged.get("engine") or None
+    model = merged.get("model") or None
+    speed = merged.get("speed", 1.0)
+    volume = merged.get("volume")
+    pitch = merged.get("pitch")
+    style_id = merged.get("style_id")
+
+    if args.command == "list":
+        return await list_engines()
+    elif args.command == "say":
+        return await play_text(
+            args.text,
+            engine,
+            speed,
+            volume,
+            pitch,
+            style_id,
+            model,
+            engine_kwargs,
+        )
+    elif args.command == "save":
+        return await synthesize_text(
+            args.text,
+            engine,
+            speed,
+            volume,
+            pitch,
+            style_id,
+            getattr(args, "output", None),
+            engine_kwargs,
+            False,
+            getattr(args, "play", False),
+        )
+    elif args.command == "test":
+        return await test_connection(
+            engine,
+            style_id,
+            engine_kwargs,
+        )
+    else:
+        parser.print_help()
+        return 1
+
+
+async def _doctor():
+    print("vox4ai 環境診断")
+    print("=" * 40)
+
+    print("\n[再生コマンド]")
+    for cmd in ("ffplay", "paplay", "aplay"):
+        found = shutil.which(cmd) is not None
+        print(f"  {cmd:12s} {'found' if found else 'not found'}")
+
+    print("\n[TTS プラグイン]")
+    try:
+        engines = ConnectorFactory.list_available()
+        if engines:
+            for eng in engines:
+                print(f"  {eng:15s} registered")
+        else:
+            print("  (none found)")
+    except Exception as e:
+        print(f"  error: {e}")
+
+    print("\n[Python パッケージ]")
+    for pkg in ("tts-plugin-bridge", "edge-tts", "aiohttp", "pydantic"):
+        try:
+            __import__(pkg.replace("-", "_"))
+            print(f"  {pkg:20s} installed")
+        except ImportError:
+            print(f"  {pkg:20s} not installed")
+
+    print()
+    return 0
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())

vox4ai-0.1.0/src/vox4ai/config.py

@@ -0,0 +1,75 @@
+import argparse
+import os
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+
+def _config_dir() -> Path:
+    xdg = os.environ.get("XDG_CONFIG_HOME")
+    if xdg:
+        return Path(xdg) / "vox4ai"
+    return Path.home() / ".config" / "vox4ai"
+
+
+def _config_path() -> Path:
+    return _config_dir() / "config.yaml"
+
+
+_DEFAULTS: dict[str, Any] = {
+    "engine": "",
+    "model": "",
+    "server_url": "",
+    "style_id": None,
+    "speed": 1.0,
+    "volume": None,
+    "pitch": None,
+}
+
+
+def defaults() -> dict[str, Any]:
+    return dict(_DEFAULTS)
+
+
+def load() -> dict[str, Any]:
+    """Load ~/.config/vox4ai/config.yaml, falling back to defaults."""
+    cfg = defaults()
+    path = _config_path()
+    if not path.exists():
+        return cfg
+    try:
+        raw = yaml.safe_load(path.read_text())
+        if isinstance(raw, dict):
+            for k in cfg:
+                if k in raw:
+                    cfg[k] = raw[k]
+    except Exception:
+        pass
+    return cfg
+
+
+def show() -> str:
+    path = _config_path()
+    if not path.exists():
+        return "(no config file)"
+    return path.read_text().strip() or "(empty)"
+
+
+def merge_cli(cfg: dict[str, Any], args: argparse.Namespace) -> dict[str, Any]:
+    """CLI args override config values. Returns merged copy."""
+    merged = dict(cfg)
+    cli_map = {
+        "engine": "engine",
+        "model": "model",
+        "server_url": "server_url",
+        "style_id": "style_id",
+        "speed": "speed",
+        "volume": "volume",
+        "pitch": "pitch",
+    }
+    for cli_attr, cfg_key in cli_map.items():
+        val = getattr(args, cli_attr, None)
+        if val is not None and val != "":
+            merged[cfg_key] = val
+    return merged