Swarmauri Text-to-Speech Agent

swarmauri_agent_texttospeech provides a stateless agent that converts each text prompt into an audio file through any Swarmauri TTSBase provider.

Features

• Converts one fresh text input into one audio file.
• Uses any provider implementing Swarmauri's TTSBase contract.
• Keeps no conversation history, memory, or system context.
• Supports synchronous, asynchronous, and batch agent execution.
• Generates distinct default paths for batch outputs.

Installation

uv add swarmauri_agent_texttospeech

pip install swarmauri_agent_texttospeech

Install a TTS provider package alongside the agent. For PlayHT:

uv add swarmauri_tts_playht

Or with pip:

pip install swarmauri_tts_playht

Usage

import os

from swarmauri_agent_texttospeech import TextToSpeechAgent
from swarmauri_tts_playht import PlayHTModel

tts = PlayHTModel(
    api_key=os.environ["PLAYHT_API_KEY"],
    user_id=os.environ["PLAYHT_USER_ID"],
    name="Play3.0-mini",
    voice="Adolfo",
)
agent = TextToSpeechAgent(tts=tts, output_path="greeting.mp3")

audio_path = agent.exec("Welcome to Swarmauri.")
print(audio_path)

Each call is independent. The agent passes only that call's text to the TTS provider and never constructs a conversation or system message.

Contributing

This package is part of the Swarmauri SDK. Contributions should follow the repository contribution and style guides.

License

Apache-2.0