swarmauri_llm_playht 0.1.1.dev2__tar.gz → 0.11.0.dev1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- swarmauri_llm_playht-0.11.0.dev1/PKG-INFO +212 -0
- swarmauri_llm_playht-0.11.0.dev1/README.md +179 -0
- {swarmauri_llm_playht-0.1.1.dev2 → swarmauri_llm_playht-0.11.0.dev1}/pyproject.toml +18 -3
- swarmauri_llm_playht-0.1.1.dev2/PKG-INFO +0 -84
- swarmauri_llm_playht-0.1.1.dev2/README.md +0 -55
- {swarmauri_llm_playht-0.1.1.dev2 → swarmauri_llm_playht-0.11.0.dev1}/LICENSE +0 -0
- {swarmauri_llm_playht-0.1.1.dev2 → swarmauri_llm_playht-0.11.0.dev1}/swarmauri_llm_playht/PlayHTModel.py +0 -0
- {swarmauri_llm_playht-0.1.1.dev2 → swarmauri_llm_playht-0.11.0.dev1}/swarmauri_llm_playht/__init__.py +0 -0
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: swarmauri_llm_playht
|
|
3
|
+
Version: 0.11.0.dev1
|
|
4
|
+
Summary: Provider-specific Swarmauri import package for PlayHT text-to-speech, voice management, async, and batch audio generation workflows.
|
|
5
|
+
License-Expression: Apache-2.0
|
|
6
|
+
License-File: LICENSE
|
|
7
|
+
Keywords: swarmauri,llm,swarmauri llm,playht,play.ht,text to speech,tts,voice cloning,speech synthesis,audio generation,voice engine,async tts,batch tts,generative audio,model
|
|
8
|
+
Author: Jacob Stewart
|
|
9
|
+
Author-email: jacob@swarmauri.com
|
|
10
|
+
Requires-Python: >=3.10,<3.15
|
|
11
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
12
|
+
Classifier: Natural Language :: English
|
|
13
|
+
Classifier: Development Status :: 3 - Alpha
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: Intended Audience :: Science/Research
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
|
|
18
|
+
Classifier: Topic :: Software Development :: Libraries
|
|
19
|
+
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
|
|
20
|
+
Classifier: Programming Language :: Python
|
|
21
|
+
Classifier: Programming Language :: Python :: 3
|
|
22
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
25
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
26
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
27
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
28
|
+
Requires-Dist: swarmauri_base
|
|
29
|
+
Requires-Dist: swarmauri_core
|
|
30
|
+
Requires-Dist: swarmauri_standard
|
|
31
|
+
Description-Content-Type: text/markdown
|
|
32
|
+
|
|
33
|
+

|
|
34
|
+
|
|
35
|
+
<p align="center">
|
|
36
|
+
<a href="https://pepy.tech/project/swarmauri_llm_playht/">
|
|
37
|
+
<img src="https://static.pepy.tech/badge/swarmauri_llm_playht/month" alt="PyPI - Downloads"/></a>
|
|
38
|
+
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht/">
|
|
39
|
+
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht.svg"/></a>
|
|
40
|
+
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
41
|
+
<img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
|
|
42
|
+
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
43
|
+
<img src="https://img.shields.io/pypi/l/swarmauri_llm_playht" alt="PyPI - License"/></a>
|
|
44
|
+
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
45
|
+
<img src="https://img.shields.io/pypi/v/swarmauri_llm_playht?label=swarmauri_llm_playht&color=green" alt="PyPI - swarmauri_llm_playht"/></a>
|
|
46
|
+
<a href="https://discord.gg/N4UpBuQv8T">
|
|
47
|
+
<img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
|
|
48
|
+
|
|
49
|
+
# Swarmauri PlayHT Voice Generation
|
|
50
|
+
|
|
51
|
+
`swarmauri_llm_playht` provides the provider-specific Swarmauri import package for `PlayHTModel`. Despite the older `llm` package name, the runtime is a PlayHT text-to-speech and voice-management adapter that synthesizes speech, enumerates available voices, and supports cloned-voice workflows through the PlayHT API.
|
|
52
|
+
|
|
53
|
+
The adapter targets PlayHT's API under `https://api.play.ht/api/v2`, supports the repo-tracked model families `Play3.0-mini`, `PlayHT2.0-turbo`, `PlayHT1.0`, and `PlayHT2.0`, and writes generated audio to a local output file.
|
|
54
|
+
|
|
55
|
+
## Why Use This Package?
|
|
56
|
+
|
|
57
|
+
- Keep PlayHT-specific imports explicit in Swarmauri applications.
|
|
58
|
+
- Generate audio from text through a Swarmauri component instead of hand-writing PlayHT HTTP requests.
|
|
59
|
+
- Reuse one adapter for synthesis, cloned-voice discovery, and cloned-voice lifecycle operations.
|
|
60
|
+
- Bridge older `llms` usage to PlayHT’s speech-generation surface while newer TTS package paths continue to evolve.
|
|
61
|
+
|
|
62
|
+
## FAQ
|
|
63
|
+
|
|
64
|
+
### What does `swarmauri_llm_playht` install?
|
|
65
|
+
|
|
66
|
+
It installs `PlayHTModel` under `swarmauri.llms`.
|
|
67
|
+
|
|
68
|
+
### Is this actually a chat LLM package?
|
|
69
|
+
|
|
70
|
+
No. The runtime is a PlayHT text-to-speech adapter with voice-management helpers. The package name reflects the older export surface, but the behavior is speech generation rather than text chat.
|
|
71
|
+
|
|
72
|
+
### Which PlayHT model families are supported?
|
|
73
|
+
|
|
74
|
+
The current allowlist includes `Play3.0-mini`, `PlayHT2.0-turbo`, `PlayHT1.0`, and `PlayHT2.0`.
|
|
75
|
+
|
|
76
|
+
### What credentials are required?
|
|
77
|
+
|
|
78
|
+
You need a PlayHT API key and user ID. The runtime expects both `api_key` and `user_id`.
|
|
79
|
+
|
|
80
|
+
### Does it support streaming?
|
|
81
|
+
|
|
82
|
+
No. `stream` and `astream` are explicitly unimplemented for `PlayHTModel`.
|
|
83
|
+
|
|
84
|
+
### Can it manage cloned voices?
|
|
85
|
+
|
|
86
|
+
Yes. The adapter includes methods to get cloned voices, clone a voice from a file or URL, and delete a cloned voice.
|
|
87
|
+
|
|
88
|
+
## Features
|
|
89
|
+
|
|
90
|
+
- `PlayHTModel` for text-to-speech synthesis against the PlayHT API.
|
|
91
|
+
- Sync and async speech generation methods that save audio to a local file path.
|
|
92
|
+
- Batch and async batch synthesis workflows.
|
|
93
|
+
- Prebuilt voice discovery and validation for the selected voice engine.
|
|
94
|
+
- Cloned voice management helpers for create, list, and delete operations.
|
|
95
|
+
- Compatibility with Python 3.10, 3.11, 3.12, 3.13, and 3.14.
|
|
96
|
+
|
|
97
|
+
## Installation
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
uv add swarmauri_llm_playht
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
pip install swarmauri_llm_playht
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Usage
|
|
108
|
+
|
|
109
|
+
Set `PLAYHT_API_KEY` and `PLAYHT_USER_ID` in your environment before creating the model.
|
|
110
|
+
|
|
111
|
+
### Text To Speech
|
|
112
|
+
|
|
113
|
+
```python
|
|
114
|
+
import os
|
|
115
|
+
|
|
116
|
+
from swarmauri_llm_playht import PlayHTModel
|
|
117
|
+
|
|
118
|
+
tts = PlayHTModel(
|
|
119
|
+
api_key=os.environ["PLAYHT_API_KEY"],
|
|
120
|
+
user_id=os.environ["PLAYHT_USER_ID"],
|
|
121
|
+
name="Play3.0-mini",
|
|
122
|
+
voice="Adolfo",
|
|
123
|
+
)
|
|
124
|
+
|
|
125
|
+
audio_path = tts.predict(
|
|
126
|
+
"Swarmauri turns provider APIs into composable components.",
|
|
127
|
+
audio_path="playht_output.mp3",
|
|
128
|
+
)
|
|
129
|
+
|
|
130
|
+
print(audio_path)
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### Async Speech Generation
|
|
134
|
+
|
|
135
|
+
```python
|
|
136
|
+
import asyncio
|
|
137
|
+
import os
|
|
138
|
+
|
|
139
|
+
from swarmauri_llm_playht import PlayHTModel
|
|
140
|
+
|
|
141
|
+
|
|
142
|
+
async def main() -> None:
|
|
143
|
+
tts = PlayHTModel(
|
|
144
|
+
api_key=os.environ["PLAYHT_API_KEY"],
|
|
145
|
+
user_id=os.environ["PLAYHT_USER_ID"],
|
|
146
|
+
name="PlayHT2.0-turbo",
|
|
147
|
+
voice="Adolfo",
|
|
148
|
+
)
|
|
149
|
+
output = await tts.apredict("Generate a short spoken greeting.", "greeting.mp3")
|
|
150
|
+
print(output)
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
# asyncio.run(main())
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### Voice Management
|
|
157
|
+
|
|
158
|
+
```python
|
|
159
|
+
import os
|
|
160
|
+
|
|
161
|
+
from swarmauri_llm_playht import PlayHTModel
|
|
162
|
+
|
|
163
|
+
tts = PlayHTModel(
|
|
164
|
+
api_key=os.environ["PLAYHT_API_KEY"],
|
|
165
|
+
user_id=os.environ["PLAYHT_USER_ID"],
|
|
166
|
+
name="PlayHT2.0",
|
|
167
|
+
voice="Adolfo",
|
|
168
|
+
)
|
|
169
|
+
|
|
170
|
+
voices = tts.get_cloned_voices()
|
|
171
|
+
print(voices)
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
## Examples
|
|
175
|
+
|
|
176
|
+
- Use `PlayHTModel` when an agent or application needs provider-hosted speech output saved to a local file.
|
|
177
|
+
- Use batch methods when one workflow needs multiple spoken outputs in one pass.
|
|
178
|
+
- Use cloned voice methods when the application manages a catalog of custom voices in PlayHT.
|
|
179
|
+
|
|
180
|
+
## Related Packages
|
|
181
|
+
|
|
182
|
+
- [swarmauri_llm_openai](https://pypi.org/project/swarmauri_llm_openai/)
|
|
183
|
+
- [swarmauri_llm_hyperbolic](https://pypi.org/project/swarmauri_llm_hyperbolic/)
|
|
184
|
+
- [swarmauri_llm_whisper](https://pypi.org/project/swarmauri_llm_whisper/)
|
|
185
|
+
- [swarmauri_llm_groq](https://pypi.org/project/swarmauri_llm_groq/)
|
|
186
|
+
- [swarmauri_llm_perplexity](https://pypi.org/project/swarmauri_llm_perplexity/)
|
|
187
|
+
- [swarmauri_llm_mistral](https://pypi.org/project/swarmauri_llm_mistral/)
|
|
188
|
+
|
|
189
|
+
## Foundational Swarmauri Packages
|
|
190
|
+
|
|
191
|
+
- [swarmauri](https://pypi.org/project/swarmauri/)
|
|
192
|
+
- [swarmauri_core](https://pypi.org/project/swarmauri_core/)
|
|
193
|
+
- [swarmauri_base](https://pypi.org/project/swarmauri_base/)
|
|
194
|
+
- [swarmauri_standard](https://pypi.org/project/swarmauri_standard/)
|
|
195
|
+
|
|
196
|
+
## More Documentation
|
|
197
|
+
|
|
198
|
+
- [LLM provider model and pricing links](../../../docs/LLM_PROVIDER_MODEL_PRICING_LINKS.md)
|
|
199
|
+
- [PlayHT API docs](https://docs.play.ht/)
|
|
200
|
+
- [PlayHT generated API reference](https://playht.github.io/api-docs-generator/)
|
|
201
|
+
|
|
202
|
+
## Best Practices
|
|
203
|
+
|
|
204
|
+
- Keep `PLAYHT_API_KEY` and `PLAYHT_USER_ID` in environment variables or a secret manager.
|
|
205
|
+
- Validate the selected voice against the chosen PlayHT voice engine before running batch jobs.
|
|
206
|
+
- Use explicit output paths so generated audio assets are easy to manage.
|
|
207
|
+
- Prefer newer Swarmauri TTS-native imports when available for new projects, since this package preserves an older compatibility surface.
|
|
208
|
+
|
|
209
|
+
## License
|
|
210
|
+
|
|
211
|
+
Apache-2.0
|
|
212
|
+
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+

|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://pepy.tech/project/swarmauri_llm_playht/">
|
|
5
|
+
<img src="https://static.pepy.tech/badge/swarmauri_llm_playht/month" alt="PyPI - Downloads"/></a>
|
|
6
|
+
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht/">
|
|
7
|
+
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht.svg"/></a>
|
|
8
|
+
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
9
|
+
<img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
|
|
10
|
+
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
11
|
+
<img src="https://img.shields.io/pypi/l/swarmauri_llm_playht" alt="PyPI - License"/></a>
|
|
12
|
+
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
13
|
+
<img src="https://img.shields.io/pypi/v/swarmauri_llm_playht?label=swarmauri_llm_playht&color=green" alt="PyPI - swarmauri_llm_playht"/></a>
|
|
14
|
+
<a href="https://discord.gg/N4UpBuQv8T">
|
|
15
|
+
<img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
|
|
16
|
+
|
|
17
|
+
# Swarmauri PlayHT Voice Generation
|
|
18
|
+
|
|
19
|
+
`swarmauri_llm_playht` provides the provider-specific Swarmauri import package for `PlayHTModel`. Despite the older `llm` package name, the runtime is a PlayHT text-to-speech and voice-management adapter that synthesizes speech, enumerates available voices, and supports cloned-voice workflows through the PlayHT API.
|
|
20
|
+
|
|
21
|
+
The adapter targets PlayHT's API under `https://api.play.ht/api/v2`, supports the repo-tracked model families `Play3.0-mini`, `PlayHT2.0-turbo`, `PlayHT1.0`, and `PlayHT2.0`, and writes generated audio to a local output file.
|
|
22
|
+
|
|
23
|
+
## Why Use This Package?
|
|
24
|
+
|
|
25
|
+
- Keep PlayHT-specific imports explicit in Swarmauri applications.
|
|
26
|
+
- Generate audio from text through a Swarmauri component instead of hand-writing PlayHT HTTP requests.
|
|
27
|
+
- Reuse one adapter for synthesis, cloned-voice discovery, and cloned-voice lifecycle operations.
|
|
28
|
+
- Bridge older `llms` usage to PlayHT’s speech-generation surface while newer TTS package paths continue to evolve.
|
|
29
|
+
|
|
30
|
+
## FAQ
|
|
31
|
+
|
|
32
|
+
### What does `swarmauri_llm_playht` install?
|
|
33
|
+
|
|
34
|
+
It installs `PlayHTModel` under `swarmauri.llms`.
|
|
35
|
+
|
|
36
|
+
### Is this actually a chat LLM package?
|
|
37
|
+
|
|
38
|
+
No. The runtime is a PlayHT text-to-speech adapter with voice-management helpers. The package name reflects the older export surface, but the behavior is speech generation rather than text chat.
|
|
39
|
+
|
|
40
|
+
### Which PlayHT model families are supported?
|
|
41
|
+
|
|
42
|
+
The current allowlist includes `Play3.0-mini`, `PlayHT2.0-turbo`, `PlayHT1.0`, and `PlayHT2.0`.
|
|
43
|
+
|
|
44
|
+
### What credentials are required?
|
|
45
|
+
|
|
46
|
+
You need a PlayHT API key and user ID. The runtime expects both `api_key` and `user_id`.
|
|
47
|
+
|
|
48
|
+
### Does it support streaming?
|
|
49
|
+
|
|
50
|
+
No. `stream` and `astream` are explicitly unimplemented for `PlayHTModel`.
|
|
51
|
+
|
|
52
|
+
### Can it manage cloned voices?
|
|
53
|
+
|
|
54
|
+
Yes. The adapter includes methods to get cloned voices, clone a voice from a file or URL, and delete a cloned voice.
|
|
55
|
+
|
|
56
|
+
## Features
|
|
57
|
+
|
|
58
|
+
- `PlayHTModel` for text-to-speech synthesis against the PlayHT API.
|
|
59
|
+
- Sync and async speech generation methods that save audio to a local file path.
|
|
60
|
+
- Batch and async batch synthesis workflows.
|
|
61
|
+
- Prebuilt voice discovery and validation for the selected voice engine.
|
|
62
|
+
- Cloned voice management helpers for create, list, and delete operations.
|
|
63
|
+
- Compatibility with Python 3.10, 3.11, 3.12, 3.13, and 3.14.
|
|
64
|
+
|
|
65
|
+
## Installation
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
uv add swarmauri_llm_playht
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
pip install swarmauri_llm_playht
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Usage
|
|
76
|
+
|
|
77
|
+
Set `PLAYHT_API_KEY` and `PLAYHT_USER_ID` in your environment before creating the model.
|
|
78
|
+
|
|
79
|
+
### Text To Speech
|
|
80
|
+
|
|
81
|
+
```python
|
|
82
|
+
import os
|
|
83
|
+
|
|
84
|
+
from swarmauri_llm_playht import PlayHTModel
|
|
85
|
+
|
|
86
|
+
tts = PlayHTModel(
|
|
87
|
+
api_key=os.environ["PLAYHT_API_KEY"],
|
|
88
|
+
user_id=os.environ["PLAYHT_USER_ID"],
|
|
89
|
+
name="Play3.0-mini",
|
|
90
|
+
voice="Adolfo",
|
|
91
|
+
)
|
|
92
|
+
|
|
93
|
+
audio_path = tts.predict(
|
|
94
|
+
"Swarmauri turns provider APIs into composable components.",
|
|
95
|
+
audio_path="playht_output.mp3",
|
|
96
|
+
)
|
|
97
|
+
|
|
98
|
+
print(audio_path)
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Async Speech Generation
|
|
102
|
+
|
|
103
|
+
```python
|
|
104
|
+
import asyncio
|
|
105
|
+
import os
|
|
106
|
+
|
|
107
|
+
from swarmauri_llm_playht import PlayHTModel
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
async def main() -> None:
|
|
111
|
+
tts = PlayHTModel(
|
|
112
|
+
api_key=os.environ["PLAYHT_API_KEY"],
|
|
113
|
+
user_id=os.environ["PLAYHT_USER_ID"],
|
|
114
|
+
name="PlayHT2.0-turbo",
|
|
115
|
+
voice="Adolfo",
|
|
116
|
+
)
|
|
117
|
+
output = await tts.apredict("Generate a short spoken greeting.", "greeting.mp3")
|
|
118
|
+
print(output)
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
# asyncio.run(main())
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Voice Management
|
|
125
|
+
|
|
126
|
+
```python
|
|
127
|
+
import os
|
|
128
|
+
|
|
129
|
+
from swarmauri_llm_playht import PlayHTModel
|
|
130
|
+
|
|
131
|
+
tts = PlayHTModel(
|
|
132
|
+
api_key=os.environ["PLAYHT_API_KEY"],
|
|
133
|
+
user_id=os.environ["PLAYHT_USER_ID"],
|
|
134
|
+
name="PlayHT2.0",
|
|
135
|
+
voice="Adolfo",
|
|
136
|
+
)
|
|
137
|
+
|
|
138
|
+
voices = tts.get_cloned_voices()
|
|
139
|
+
print(voices)
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## Examples
|
|
143
|
+
|
|
144
|
+
- Use `PlayHTModel` when an agent or application needs provider-hosted speech output saved to a local file.
|
|
145
|
+
- Use batch methods when one workflow needs multiple spoken outputs in one pass.
|
|
146
|
+
- Use cloned voice methods when the application manages a catalog of custom voices in PlayHT.
|
|
147
|
+
|
|
148
|
+
## Related Packages
|
|
149
|
+
|
|
150
|
+
- [swarmauri_llm_openai](https://pypi.org/project/swarmauri_llm_openai/)
|
|
151
|
+
- [swarmauri_llm_hyperbolic](https://pypi.org/project/swarmauri_llm_hyperbolic/)
|
|
152
|
+
- [swarmauri_llm_whisper](https://pypi.org/project/swarmauri_llm_whisper/)
|
|
153
|
+
- [swarmauri_llm_groq](https://pypi.org/project/swarmauri_llm_groq/)
|
|
154
|
+
- [swarmauri_llm_perplexity](https://pypi.org/project/swarmauri_llm_perplexity/)
|
|
155
|
+
- [swarmauri_llm_mistral](https://pypi.org/project/swarmauri_llm_mistral/)
|
|
156
|
+
|
|
157
|
+
## Foundational Swarmauri Packages
|
|
158
|
+
|
|
159
|
+
- [swarmauri](https://pypi.org/project/swarmauri/)
|
|
160
|
+
- [swarmauri_core](https://pypi.org/project/swarmauri_core/)
|
|
161
|
+
- [swarmauri_base](https://pypi.org/project/swarmauri_base/)
|
|
162
|
+
- [swarmauri_standard](https://pypi.org/project/swarmauri_standard/)
|
|
163
|
+
|
|
164
|
+
## More Documentation
|
|
165
|
+
|
|
166
|
+
- [LLM provider model and pricing links](../../../docs/LLM_PROVIDER_MODEL_PRICING_LINKS.md)
|
|
167
|
+
- [PlayHT API docs](https://docs.play.ht/)
|
|
168
|
+
- [PlayHT generated API reference](https://playht.github.io/api-docs-generator/)
|
|
169
|
+
|
|
170
|
+
## Best Practices
|
|
171
|
+
|
|
172
|
+
- Keep `PLAYHT_API_KEY` and `PLAYHT_USER_ID` in environment variables or a secret manager.
|
|
173
|
+
- Validate the selected voice against the chosen PlayHT voice engine before running batch jobs.
|
|
174
|
+
- Use explicit output paths so generated audio assets are easy to manage.
|
|
175
|
+
- Prefer newer Swarmauri TTS-native imports when available for new projects, since this package preserves an older compatibility surface.
|
|
176
|
+
|
|
177
|
+
## License
|
|
178
|
+
|
|
179
|
+
Apache-2.0
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "swarmauri_llm_playht"
|
|
3
|
-
version = "0.
|
|
4
|
-
description = "Swarmauri
|
|
3
|
+
version = "0.11.0.dev1"
|
|
4
|
+
description = "Provider-specific Swarmauri import package for PlayHT text-to-speech, voice management, async, and batch audio generation workflows."
|
|
5
5
|
license = "Apache-2.0"
|
|
6
6
|
readme = "README.md"
|
|
7
7
|
repository = "http://github.com/swarmauri/swarmauri-sdk"
|
|
@@ -11,6 +11,10 @@ classifiers = [
|
|
|
11
11
|
"Natural Language :: English",
|
|
12
12
|
"Development Status :: 3 - Alpha",
|
|
13
13
|
"Intended Audience :: Developers",
|
|
14
|
+
"Intended Audience :: Science/Research",
|
|
15
|
+
"Operating System :: OS Independent",
|
|
16
|
+
"Topic :: Multimedia :: Sound/Audio :: Speech",
|
|
17
|
+
"Topic :: Software Development :: Libraries",
|
|
14
18
|
"Topic :: Software Development :: Libraries :: Application Frameworks",
|
|
15
19
|
"Programming Language :: Python",
|
|
16
20
|
"Programming Language :: Python :: 3",
|
|
@@ -30,7 +34,18 @@ dependencies = [
|
|
|
30
34
|
keywords = [
|
|
31
35
|
"swarmauri",
|
|
32
36
|
"llm",
|
|
37
|
+
"swarmauri llm",
|
|
33
38
|
"playht",
|
|
39
|
+
"play.ht",
|
|
40
|
+
"text to speech",
|
|
41
|
+
"tts",
|
|
42
|
+
"voice cloning",
|
|
43
|
+
"speech synthesis",
|
|
44
|
+
"audio generation",
|
|
45
|
+
"voice engine",
|
|
46
|
+
"async tts",
|
|
47
|
+
"batch tts",
|
|
48
|
+
"generative audio",
|
|
34
49
|
"model",
|
|
35
50
|
]
|
|
36
51
|
|
|
@@ -73,7 +88,7 @@ dev = [
|
|
|
73
88
|
"pytest-xdist>=3.6.1",
|
|
74
89
|
"pytest-json-report>=1.5.0",
|
|
75
90
|
"python-dotenv",
|
|
76
|
-
"
|
|
91
|
+
"httpx>=0.27",
|
|
77
92
|
"flake8>=7.0",
|
|
78
93
|
"pytest-timeout>=2.3.1",
|
|
79
94
|
"ruff>=0.9.9",
|
|
@@ -1,84 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: swarmauri_llm_playht
|
|
3
|
-
Version: 0.1.1.dev2
|
|
4
|
-
Summary: Swarmauri Playht LLM adapters from swarmauri_standard.
|
|
5
|
-
License-Expression: Apache-2.0
|
|
6
|
-
License-File: LICENSE
|
|
7
|
-
Keywords: swarmauri,llm,playht,model
|
|
8
|
-
Author: Jacob Stewart
|
|
9
|
-
Author-email: jacob@swarmauri.com
|
|
10
|
-
Requires-Python: >=3.10,<3.15
|
|
11
|
-
Classifier: License :: OSI Approved :: Apache Software License
|
|
12
|
-
Classifier: Natural Language :: English
|
|
13
|
-
Classifier: Development Status :: 3 - Alpha
|
|
14
|
-
Classifier: Intended Audience :: Developers
|
|
15
|
-
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
|
|
16
|
-
Classifier: Programming Language :: Python
|
|
17
|
-
Classifier: Programming Language :: Python :: 3
|
|
18
|
-
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
20
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
21
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
22
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
23
|
-
Classifier: Programming Language :: Python :: 3.14
|
|
24
|
-
Requires-Dist: swarmauri_base
|
|
25
|
-
Requires-Dist: swarmauri_core
|
|
26
|
-
Requires-Dist: swarmauri_standard
|
|
27
|
-
Description-Content-Type: text/markdown
|
|
28
|
-
|
|
29
|
-

|
|
30
|
-
|
|
31
|
-
<p align="center">
|
|
32
|
-
<a href="https://pepy.tech/project/swarmauri_llm_playht/">
|
|
33
|
-
<img src="https://static.pepy.tech/badge/swarmauri_llm_playht/month" alt="PyPI - Downloads"/></a>
|
|
34
|
-
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht/">
|
|
35
|
-
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht.svg"/></a>
|
|
36
|
-
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
37
|
-
<img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
|
|
38
|
-
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
39
|
-
<img src="https://img.shields.io/pypi/l/swarmauri_llm_playht" alt="PyPI - License"/></a>
|
|
40
|
-
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
41
|
-
<img src="https://img.shields.io/pypi/v/swarmauri_llm_playht?label=swarmauri_llm_playht&color=green" alt="PyPI - swarmauri_llm_playht"/></a>
|
|
42
|
-
</p>
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
# swarmauri_llm_playht
|
|
46
|
-
|
|
47
|
-
Provider-specific Playht LLM package for Swarmauri. This package offers direct imports for PlayHTModel while keeping implementation parity with `swarmauri_standard`.
|
|
48
|
-
|
|
49
|
-
## Features
|
|
50
|
-
|
|
51
|
-
- `PlayHTModel` adapter exported from `swarmauri_standard.llms.PlayHTModel`.
|
|
52
|
-
- Compatible with Python 3.10 through 3.12.
|
|
53
|
-
|
|
54
|
-
## Installation
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
# uv
|
|
58
|
-
uv add swarmauri_llm_playht
|
|
59
|
-
|
|
60
|
-
# pip
|
|
61
|
-
pip install swarmauri_llm_playht
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
## Usage
|
|
65
|
-
|
|
66
|
-
```python
|
|
67
|
-
from swarmauri_llm_playht import PlayHTModel
|
|
68
|
-
from swarmauri_standard.conversations.Conversation import Conversation
|
|
69
|
-
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
70
|
-
|
|
71
|
-
conversation = Conversation()
|
|
72
|
-
conversation.add_message(HumanMessage(content="Hello from Swarmauri"))
|
|
73
|
-
|
|
74
|
-
model = PlayHTModel()
|
|
75
|
-
# Configure provider credentials before making requests.
|
|
76
|
-
# result = model.predict(conversation=conversation)
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
## Workflow Notes
|
|
80
|
-
|
|
81
|
-
- These adapters intentionally mirror the corresponding classes in `swarmauri_standard`.
|
|
82
|
-
- Use the provider package that matches your deployment and credential setup.
|
|
83
|
-
- Install only the provider packages you need to keep dependencies minimal.
|
|
84
|
-
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-

|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<a href="https://pepy.tech/project/swarmauri_llm_playht/">
|
|
5
|
-
<img src="https://static.pepy.tech/badge/swarmauri_llm_playht/month" alt="PyPI - Downloads"/></a>
|
|
6
|
-
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht/">
|
|
7
|
-
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_playht.svg"/></a>
|
|
8
|
-
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
9
|
-
<img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
|
|
10
|
-
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
11
|
-
<img src="https://img.shields.io/pypi/l/swarmauri_llm_playht" alt="PyPI - License"/></a>
|
|
12
|
-
<a href="https://pypi.org/project/swarmauri_llm_playht/">
|
|
13
|
-
<img src="https://img.shields.io/pypi/v/swarmauri_llm_playht?label=swarmauri_llm_playht&color=green" alt="PyPI - swarmauri_llm_playht"/></a>
|
|
14
|
-
</p>
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
# swarmauri_llm_playht
|
|
18
|
-
|
|
19
|
-
Provider-specific Playht LLM package for Swarmauri. This package offers direct imports for PlayHTModel while keeping implementation parity with `swarmauri_standard`.
|
|
20
|
-
|
|
21
|
-
## Features
|
|
22
|
-
|
|
23
|
-
- `PlayHTModel` adapter exported from `swarmauri_standard.llms.PlayHTModel`.
|
|
24
|
-
- Compatible with Python 3.10 through 3.12.
|
|
25
|
-
|
|
26
|
-
## Installation
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
# uv
|
|
30
|
-
uv add swarmauri_llm_playht
|
|
31
|
-
|
|
32
|
-
# pip
|
|
33
|
-
pip install swarmauri_llm_playht
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Usage
|
|
37
|
-
|
|
38
|
-
```python
|
|
39
|
-
from swarmauri_llm_playht import PlayHTModel
|
|
40
|
-
from swarmauri_standard.conversations.Conversation import Conversation
|
|
41
|
-
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
42
|
-
|
|
43
|
-
conversation = Conversation()
|
|
44
|
-
conversation.add_message(HumanMessage(content="Hello from Swarmauri"))
|
|
45
|
-
|
|
46
|
-
model = PlayHTModel()
|
|
47
|
-
# Configure provider credentials before making requests.
|
|
48
|
-
# result = model.predict(conversation=conversation)
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## Workflow Notes
|
|
52
|
-
|
|
53
|
-
- These adapters intentionally mirror the corresponding classes in `swarmauri_standard`.
|
|
54
|
-
- Use the provider package that matches your deployment and credential setup.
|
|
55
|
-
- Install only the provider packages you need to keep dependencies minimal.
|
|
File without changes
|
|
File without changes
|
|
File without changes
|