vox4ai-skill-lib

Website • Report Bug • Contributing

🚀 Overview

Python ライブラリとしての TTS Skill — AI agent や CLI から tts-plugin-bridge の TTS Engine を統一的に操作します。

📦 Installation

uv add vox4ai-skill-lib

🛠 Usage

🧩 TTSSkill（推奨）

import asyncio
from vox4ai_skill_lib import TTSSkill

async def main():
    async with TTSSkill(default_engine="edgetts") as skill:
        # 音声合成（Base64 で音声データ取得）
        result = await skill.synthesize(text="こんにちは")
        print(result["status"])  # "ok"

        # ファイル保存
        result = await skill.save(text="こんにちは")

        # ストリーミング再生（ffplay 優先）
        result = await skill.say(text="こんにちは")

        # モデル指定
        result = await skill.synthesize(
            text="こんにちは",
            model="ja-JP-KeitaNeural",
        )

asyncio.run(main())

⌨️ API 関数（簡易呼び出し用）

import asyncio
from vox4ai_skill_lib.api import list_engines, play_text

async def main():
    await list_engines()
    await play_text("こんにちは", engine="edgetts", speed=1.0,
                    volume=None, pitch=None, style_id=None,
                    model="ja-JP-NanamiNeural", engine_kwargs={})

asyncio.run(main())

📑 TTSSkill API

全メソッドで model / pitch / volume / style_id / engine を kwargs として受け付けます。

コンテキストマネージャ対応:

async with TTSSkill(default_engine="edgetts") as skill:
    result = await skill.synthesize(text="test")
# close() 自動呼び出し

📑 API 関数

📦 Dependencies

• tts-plugin-bridge — コアフレームワーク（protocol / factory / chunker）
• aiohttp — 非同期 HTTP

📜 License

MIT License