Skip to main content
Pre-release

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

Swarmauri Logo

swarmauri_tts_azure

Alpha Swarmauri Azure Speech TTS provider. Public-cloud regional REST synthesis using a Speech resource key and escaped SSML. name is the voice ShortName, rather than a separate model ID.

Downloads Hits Python License Version

Features

  • File synthesis, asynchronous synthesis and bounded batches through TTSBase.
  • Incremental HTTP audio with response cleanup on stream cancellation.
  • Provider-specific authentication, encoding and region configuration.
  • No automatic replay of billable synthesis requests.

Installation

uv add --prerelease allow swarmauri_tts_azure
pip install --pre swarmauri_tts_azure

Python 3.10-3.14. This source candidate requires the companion swarmauri_base>=0.11.0.dev12 release before index installation.

Usage

import os
from swarmauri_tts_azure import AzureTTS

provider = AzureTTS(
    api_key=os.environ["AZURE_SPEECH_KEY"],
    region=os.environ["AZURE_SPEECH_REGION"],
    name="en-US-JennyNeural",
)
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).

Use the component with TextToSpeechAgent. Select a filename matching the output format; HTTP chunks retain that codec. No realtime latency claim is made.

Configuration and API scope

The initial voices are en-US-JennyNeural (default), en-US-AriaNeural and en-US-GuyNeural, with locale="en-US". The input is plain text: markup and XML characters are escaped into a single SSML voice element. Invalid XML control characters fail locally. Custom voice deployments, raw user-supplied SSML, Entra/STS token acquisition, sovereign/private endpoints and batch/Long Audio APIs are excluded. Regional stock-voice availability needs live verification.

output_format supports audio-24khz-48kbitrate-mono-mp3 (default), riff-24khz-16bit-mono-pcm (WAV), raw-24khz-16bit-mono-pcm, raw-8khz-8bit-mono-mulaw and ogg-24khz-16bit-mono-opus. Raw PCM/mulaw have no container header. Filenames do not change codecs. The REST service limits generated audio to ten minutes; this adapter does not silently split long text. Event-driven Speech SDK features need another interface.

Primary reference: Azure Speech synthesis API.

Verification and alpha status

Live API behavior remains unverified; tracked in #6302. No paid synthesis was run. Offline contract tests do not establish account/model availability, output playability, quality, latency or billed cost. Keep Development Status :: 3 - Alpha in pyproject.toml until maintainers review sufficient live evidence.

The live suite requires explicit SWARMAURI_LIVE_TTS=1 plus private AZURE_SPEECH_KEY and AZURE_SPEECH_REGION. A credential alone never enables it. Run the package's tests/i9n suite. By default only predict runs (one billable request). Select additional operations with SWARMAURI_LIVE_TTS_OPERATIONS=predict,apredict,stream,astream,batch,abatch (eight requests per model/voice because each batch has two inputs). Set SWARMAURI_TTS_MODEL to the engine (Polly) or voice ShortName (Azure). Azure does not use SWARMAURI_TTS_VOICE. Never paste secrets or unmasked authorization headers in logs or issues. See the verification tracker.

License

Apache-2.0. Part of the Swarmauri SDK.

Metadata

Release files for swarmauri_tts_azure 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_azure 0.1.0a1
File Size Uploaded Provenance Actions
swarmauri_tts_azure-0.1.0a1.tar.gz 8.3 kB Without provenance Details for swarmauri_tts_azure-0.1.0a1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for swarmauri_tts_azure 0.1.0a1
File Interpreter ABI Platform Actions
swarmauri_tts_azure-0.1.0a1-py3-none-any.whl Python 3 none any Details for swarmauri_tts_azure-0.1.0a1-py3-none-any.whl

Total release size: 18.4 kB

Release files / swarmauri_tts_azure-0.1.0a1.tar.gz

Download URL swarmauri_tts_azure-0.1.0a1.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
7743404930b3b03a0de1fa5dd0a2d650f3c00ab082d431bb1249d57481c53c23
BLAKE2b-256 checksum
How to use checksums
8b7b7ec3a1485b2903d3ccef6c991363bd755ea6796680dce4e1f999fd2040f5
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_azure-0.1.0a1-py3-none-any.whl

Download URL swarmauri_tts_azure-0.1.0a1-py3-none-any.whl
Size 10.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bbe13674deee280c1b7f6165d6cda08b23b710a5859b8c98cf28e2ea15750d6d
BLAKE2b-256 checksum
How to use checksums
e1f87b825f0fab1f19637650cf456b7476262d625b7a87f7851dd0478d637e9e
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_azure 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