Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Swarmauri Logo

swarmauri_tts_elevenlabs_dialogue

Alpha Swarmauri ElevenLabsDialogueTTS component. Ordered text/voice turns on the dialogue API, separate from single-speaker ElevenLabs TTS.

Downloads Hits Python License Version

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)

Source distribution for swarmauri_tts_elevenlabs_dialogue 0.1.0a1
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)

Table of built distributions (wheels) for swarmauri_tts_elevenlabs_dialogue 0.1.0a1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page