Audio Tools

from praisonai.tools.audio import tts_tool

result = tts_tool("Hello world!", voice="alloy")

if result["success"]:
    print(result["audio_path"])   # /tmp/tts_abc123.mp3
    print(result["media_line"])   # MEDIA:/tmp/tts_abc123.mp3

from praisonai.tools.audio import create_tts_tool
from praisonaiagents import Agent

agent = Agent(
    name="speaker",
    tools=[create_tts_tool()]
)

# Agent calls tts() tool internally
agent.chat("Convert 'Hello world' to speech")

from praisonai.tools.audio import stt_tool

result = stt_tool("recording.mp3", language="en")

if result["success"]:
    print(result["text"])  # Transcribed text

from praisonai.tools.audio import create_stt_tool
from praisonaiagents import Agent

agent = Agent(
    name="listener",
    tools=[create_stt_tool()]
)

# Agent calls stt() tool internally
agent.chat("Transcribe the file at /path/to/audio.mp3")