This release is a pre-release and may not be stable for production use.
swarmauri_tts_elevenlabs
Alpha Swarmauri ElevenLabs speech provider. Single-speaker speech and stream endpoints for Multilingual v2 and Flash v2.5. Dialogue, v4/Turbo dialogue interfaces, WebSockets and cloning are excluded.
Features
- Synchronous/asynchronous file generation and bounded batches.
- Incremental HTTP audio with cancellation cleanup.
- Provider-specific authentication, payloads, formats and model validation.
- Fixed provider endpoints; no automatic replay of billable requests.
voice must be an account-accessible voice ID. HTTP chunks retain the selected output codec. No realtime latency claim is made.
Installation
uv add --prerelease allow swarmauri_tts_elevenlabs
pip install --pre swarmauri_tts_elevenlabs
This source candidate requires the companion swarmauri_base>=0.11.0.dev12
release before these alpha packages can be installed from the index.
Usage
Set ELEVENLABS_API_KEY privately. Use a model and voice available to your own account.
import os
from swarmauri_tts_elevenlabs import ElevenLabsTTS
provider = ElevenLabsTTS(
api_key=os.environ["ELEVENLABS_API_KEY"],
name="eleven_multilingual_v2",
voice="JBFqnCBsd6RMkjVDRZzb",
)
path = provider.predict("Welcome to Swarmauri.", "welcome.mp3")
# await provider.apredict(text, audio_path)
# provider.batch({"Hello": "hello.mp3"})
# await provider.abatch({"Hello": "hello.mp3"}, max_concurrent=2)
# Iterate provider.stream(text), or async-iterate provider.astream(text).
The filename does not convert the codec. Select matching output settings and
extensions. The component implements TTSBase for TextToSpeechAgent use.
Models and output settings
The initial model list is eleven_multilingual_v2 (default) and
eleven_flash_v2_5. Use output_format="mp3_44100_128" (default),
"pcm_24000" or "ulaw_8000". PCM and mulaw output are headerless;
select a matching extension and playback configuration. Account tiers can
restrict formats. Optional stability and similarity_boost each range
from 0 to 1. The voice ID selects both unary and streaming URLs.
Verification and alpha status
Live API behavior is unverified; tracked in #6295. No paid synthesis was run. Offline tests
cover transport and documented schemas, not account/model availability,
playability, latency, pricing or quality. Keep Development Status :: 3 - Alpha
in pyproject.toml until maintainers review sufficient live evidence.
Live tests require both ELEVENLABS_API_KEY and SWARMAURI_LIVE_TTS=1.
An explicit SWARMAURI_TTS_VOICE is required.
By default only predict runs (one request). Set
SWARMAURI_LIVE_TTS_OPERATIONS=predict,apredict,stream,astream,batch,abatch
to select all operations (eight requests per model). Use
SWARMAURI_TTS_MODEL and SWARMAURI_TTS_VOICE for model-specific checks.
Never paste keys into logs or issues. See the
verification tracker.
License
Apache-2.0. Part of the Swarmauri SDK.
Metadata
Release files for swarmauri_tts_elevenlabs 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-0.1.0a1.tar.gz | 7.9 kB | Without provenance | Details for swarmauri_tts_elevenlabs-0.1.0a1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_tts_elevenlabs-0.1.0a1-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_tts_elevenlabs-0.1.0a1-py3-none-any.whl |
Total release size: 17.6 kB
Release files / swarmauri_tts_elevenlabs-0.1.0a1.tar.gz
| Download URL | swarmauri_tts_elevenlabs-0.1.0a1.tar.gz |
|---|---|
| Size | 7.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a36bb489b7a05a67c8cb15e030018bb26d7d7ba44ae91120259127b7dd85e56
|
|
BLAKE2b-256 checksum How to use checksums |
b527bc116c0d24c310d90c7d94c76d5a97fd0be15accaaa034f7d9bb9702b85b
|
| 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-0.1.0a1-py3-none-any.whl
| Download URL | swarmauri_tts_elevenlabs-0.1.0a1-py3-none-any.whl |
|---|---|
| Size | 9.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
be6d9c9c681236b84abd7980e374401685a6006d0170ddfff1ef4fee290a3c20
|
|
BLAKE2b-256 checksum How to use checksums |
aeaadda20608f93b29f437e8fad002fe9b0bc73a0829e4d0d90c5f3fd5889bca
|
| 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 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.