Metadata-Version: 2.4
Name: swarmauri_tts_together
Version: 0.1.0a2
Summary: Alpha Swarmauri together text-to-speech provider with file synthesis, async execution, streaming and bounded batches; live API verification pending.
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: swarmauri,together,tts,text-to-speech,speech-synthesis,audio-streaming,async-audio,alpha-provider
Author: Jacob Stewart
Author-email: jacob@swarmauri.com
Requires-Python: >=3.10,<3.15
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software 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: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Dist: httpx (>=0.27,<0.29)
Requires-Dist: pydantic (>=2.0)
Requires-Dist: swarmauri_base (>=0.11.0.dev13,<0.12)
Project-URL: Issues, https://github.com/swarmauri/swarmauri-sdk/issues
Project-URL: Repository, https://github.com/swarmauri/swarmauri-sdk
Description-Content-Type: text/markdown

![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)

# swarmauri_tts_together

Standalone alpha together speech synthesis for Swarmauri. Together `/v1/audio/speech`: Orpheus and Kokoro. HTTP file synthesis and SSE audio streaming are implemented. WebSocket sessions are excluded.

[![Downloads](https://img.shields.io/pypi/dm/swarmauri_tts_together)](https://pepy.tech/projects/swarmauri_tts_together)
[![Hits](https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_tts_together.svg)](https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_tts_together)
[![Python](https://img.shields.io/pypi/pyversions/swarmauri_tts_together)](https://pypi.org/project/swarmauri_tts_together/)
[![License](https://img.shields.io/pypi/l/swarmauri_tts_together)](https://pypi.org/project/swarmauri_tts_together/)
[![Version](https://img.shields.io/pypi/v/swarmauri_tts_together?label=swarmauri_tts_together&color=green)](https://pypi.org/project/swarmauri_tts_together/)

## Features

- File generation through `predict` and `apredict`.
- Incremental audio through `stream` and `astream`, with connection cleanup.
- Synchronous batch execution and bounded async batches.
- Explicit provider URL, model, voice and output settings.
- No automatic retries of potentially billable generation requests.

Together streaming always returns decoded raw PCM (16-bit little-endian at `sample_rate`, default 24000 Hz), while `response_format` controls complete file output. SSE framing is parsed rather than returned as audio.

## Installation

```bash
uv add --prerelease allow swarmauri_tts_together
```

```bash
pip install --pre swarmauri_tts_together
```

This source candidate requires the companion `swarmauri_base` release providing
`HttpTTSMixin` (`>=0.11.0.dev8`). Release that dependency before these wheels.

## Usage

Set `TOGETHER_API_KEY` in your environment, then:

```python
import os
from swarmauri_tts_together import TogetherTTS

provider = TogetherTTS(
    api_key=os.environ["TOGETHER_API_KEY"],
    name="canopylabs/orpheus-3b-0.1-ft",
    voice="tara",
)
path = provider.predict("Welcome to Swarmauri.", "welcome.mp3")
# await provider.apredict(text, audio_path)
# provider.batch({"First message": "first.mp3"})
# await provider.abatch({"Second message": "second.mp3"}, max_concurrent=2)
# Iterate provider.stream(text), or async-iterate provider.astream(text).
```

Choose voices appropriate to the selected model. The filename does not change the
codec: select `response_format` explicitly and use a matching extension. The
component implements `TTSBase` and can be passed to `TextToSpeechAgent`.

## Verification and alpha status

Live API behavior has **not** been verified by this change.
Tracked in [verification issue #6270](https://github.com/swarmauri/swarmauri-sdk/issues/6270). Offline tests validate
payloads, errors and transport behavior; they do not establish speech quality,
model availability or actual billed cost. Keep `Development Status :: 3 - Alpha`
in `pyproject.toml` until maintainers review live verification evidence.

Live tests are disabled even if a key is present. To explicitly authorize one
billable synthesis request, set `SWARMAURI_LIVE_TTS=1`, set `TOGETHER_API_KEY` privately,
and run this package's `tests/i9n` suite. Only `predict` runs by default. Set
`SWARMAURI_LIVE_TTS_OPERATIONS=predict,apredict,stream,astream,batch,abatch` to
exercise all operations (eight requests including the two-item batches). Set
`SWARMAURI_TTS_MODEL` and `SWARMAURI_TTS_VOICE` to select another model/voice.
Do not paste API keys into issues or logs.

Verification issue links and evidence requirements are maintained in
[the verification guide](https://github.com/swarmauri/swarmauri-sdk/blob/master/docs/verification/tts-providers.md).

## License

Apache-2.0. Part of the [Swarmauri SDK](https://github.com/swarmauri/swarmauri-sdk).

