This release is a pre-release and may not be stable for production use.
swarmauri_tts_elevenlabs_dialogue
Alpha Swarmauri ElevenLabsDialogueTTS component. Ordered text/voice turns on the dialogue API, separate from single-speaker ElevenLabs TTS.
Features
- Structured multi-voice files, async synthesis, streams and bounded batches.
- Provider-specific schemas and local input validation.
- Fixed provider endpoints and no automatic replay of billable requests.
- Python 3.10-3.14; no swarmauri_standard dependency.
Installation
uv add --prerelease allow swarmauri_tts_elevenlabs_dialogue
pip install --pre swarmauri_tts_elevenlabs_dialogue
This source candidate needs swarmauri_base>=0.11.0.dev12 published first.
Usage
import os
from swarmauri_tts_elevenlabs_dialogue import ElevenLabsDialogueTTS, DialogueTurn
provider = ElevenLabsDialogueTTS(api_key=os.environ["ELEVENLABS_API_KEY"])
turns = (
DialogueTurn(text="[curious] Hello?", voice_id=os.environ["VOICE_ONE"]),
DialogueTurn(text="Hello back!", voice_id=os.environ["VOICE_TWO"]),
)
path = provider.predict(turns, "dialogue.mp3")
# await provider.apredict(turns, "dialogue.mp3")
# provider.batch({turns: "dialogue.mp3"})
# await provider.abatch({turns: "dialogue.mp3"}, max_concurrent=2)
# Iterate provider.stream(turns), or async-iterate provider.astream(turns).
API boundary
Use a tuple of frozen DialogueTurn values, including as batch dictionary keys. The order and voice IDs are preserved. Plain strings require default_voice_id; that mode also works with TextToSpeechAgent. JSON text is never interpreted as a turn list. The component enforces ten unique voices and a conservative 2000 character total, following the reliable-generation guidance. Model IDs are eleven_v4 (default) and eleven_v3. output_format supports mp3_44100_128 (default), pcm_24000 and ulaw_8000. Streaming uses /v1/text-to-dialogue/stream; output retains the selected codec. Voice cloning, timestamps and WebSockets are outside this interface. Raw PCM/mulaw need matching playback settings, not an MP3 decoder.
Primary reference: provider API.
Verification and alpha status
Live API behavior is unverified; tracked in #6304. No paid synthesis was run. Retain version 0.1.0a1 and Development Status :: 3 - Alpha until maintainers review sufficient live evidence. Mocked schemas do not prove playable audio, model availability, voice controls, quality, latency or cost.
Live tests require SWARMAURI_LIVE_TTS=1 plus private ELEVENLABS_API_KEY. Configure SWARMAURI_TTS_VOICE and SWARMAURI_TTS_SECOND_VOICE for your account. Select the model with SWARMAURI_TTS_MODEL. A key alone never enables the suite. Default selection is predict only (one billable request). SWARMAURI_LIVE_TTS_OPERATIONS selects a comma-separated operation list. All six operations make eight billable requests per model. Never paste credentials or unmasked headers into issues or logs. See the verification tracker.
License
Apache-2.0. Part of the Swarmauri SDK.
Metadata
Release files for swarmauri_tts_elevenlabs_dialogue 0.1.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| swarmauri_tts_elevenlabs_dialogue-0.1.0a1.tar.gz | 8.5 kB | Without provenance | Details for swarmauri_tts_elevenlabs_dialogue-0.1.0a1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_tts_elevenlabs_dialogue-0.1.0a1-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_tts_elevenlabs_dialogue-0.1.0a1-py3-none-any.whl |
Total release size: 19.0 kB
Release files / swarmauri_tts_elevenlabs_dialogue-0.1.0a1.tar.gz
| Download URL | swarmauri_tts_elevenlabs_dialogue-0.1.0a1.tar.gz |
|---|---|
| Size | 8.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75ac3c9ad014031fbc56e48aa1609bd6a3523ef94caff2b1bbc6b74ca4e5aed2
|
|
BLAKE2b-256 checksum How to use checksums |
73d60ddaa04117eb20a1afe1f3c1b23990c914ce7afc1d5b4804e9589b0a57f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / swarmauri_tts_elevenlabs_dialogue-0.1.0a1-py3-none-any.whl
| Download URL | swarmauri_tts_elevenlabs_dialogue-0.1.0a1-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
556cbec0bc98a0a3ff8961c9792becaf3db9c0a6f227833778f9d201438fdcd9
|
|
BLAKE2b-256 checksum How to use checksums |
25e8d939ac51bab489d9d6aeb3fe500cd682aa962c7d94ef94a7a787b19f9217
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for swarmauri_tts_elevenlabs_dialogue 0.1.0a1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.