swarmauri_llm_hyperbolic 0.1.1.dev3__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_hyperbolic-0.11.0.dev1/PKG-INFO +247 -0
- swarmauri_llm_hyperbolic-0.11.0.dev1/README.md +213 -0
- {swarmauri_llm_hyperbolic-0.1.1.dev3 → swarmauri_llm_hyperbolic-0.11.0.dev1}/pyproject.toml +25 -3
- swarmauri_llm_hyperbolic-0.1.1.dev3/PKG-INFO +0 -87
- swarmauri_llm_hyperbolic-0.1.1.dev3/README.md +0 -58
- {swarmauri_llm_hyperbolic-0.1.1.dev3 → swarmauri_llm_hyperbolic-0.11.0.dev1}/LICENSE +0 -0
- {swarmauri_llm_hyperbolic-0.1.1.dev3 → swarmauri_llm_hyperbolic-0.11.0.dev1}/swarmauri_llm_hyperbolic/HyperbolicAudioTTS.py +0 -0
- {swarmauri_llm_hyperbolic-0.1.1.dev3 → swarmauri_llm_hyperbolic-0.11.0.dev1}/swarmauri_llm_hyperbolic/HyperbolicModel.py +0 -0
- {swarmauri_llm_hyperbolic-0.1.1.dev3 → swarmauri_llm_hyperbolic-0.11.0.dev1}/swarmauri_llm_hyperbolic/HyperbolicVisionModel.py +0 -0
- {swarmauri_llm_hyperbolic-0.1.1.dev3 → swarmauri_llm_hyperbolic-0.11.0.dev1}/swarmauri_llm_hyperbolic/__init__.py +0 -0
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: swarmauri_llm_hyperbolic
|
|
3
|
+
Version: 0.11.0.dev1
|
|
4
|
+
Summary: Provider-specific Swarmauri import package for Hyperbolic OpenAI-compatible chat, vision-language inference, streaming, and text-to-speech workflows.
|
|
5
|
+
License-Expression: Apache-2.0
|
|
6
|
+
License-File: LICENSE
|
|
7
|
+
Keywords: swarmauri,llm,hyperbolic,hyperbolic api,openai compatible,chat completions,vision language model,vlm,text to speech,tts,audio generation,streaming llm,async llm,qwen,llama,deepseek,large language model,generative ai,swarmauri llm,model,composable intelligence
|
|
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 :: Scientific/Engineering :: Artificial Intelligence
|
|
19
|
+
Classifier: Topic :: Software Development :: Libraries
|
|
20
|
+
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
|
|
21
|
+
Classifier: Programming Language :: Python
|
|
22
|
+
Classifier: Programming Language :: Python :: 3
|
|
23
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
25
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
26
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
27
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
28
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
29
|
+
Requires-Dist: swarmauri_base
|
|
30
|
+
Requires-Dist: swarmauri_core
|
|
31
|
+
Requires-Dist: swarmauri_standard
|
|
32
|
+
Description-Content-Type: text/markdown
|
|
33
|
+
|
|
34
|
+

|
|
35
|
+
|
|
36
|
+
<p align="center">
|
|
37
|
+
<a href="https://pepy.tech/project/swarmauri_llm_hyperbolic/">
|
|
38
|
+
<img src="https://static.pepy.tech/badge/swarmauri_llm_hyperbolic/month" alt="PyPI - Downloads"/></a>
|
|
39
|
+
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_hyperbolic/">
|
|
40
|
+
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_hyperbolic.svg"/></a>
|
|
41
|
+
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
42
|
+
<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>
|
|
43
|
+
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
44
|
+
<img src="https://img.shields.io/pypi/l/swarmauri_llm_hyperbolic" alt="PyPI - License"/></a>
|
|
45
|
+
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
46
|
+
<img src="https://img.shields.io/pypi/v/swarmauri_llm_hyperbolic?label=swarmauri_llm_hyperbolic&color=green" alt="PyPI - swarmauri_llm_hyperbolic"/></a>
|
|
47
|
+
<a href="https://discord.gg/N4UpBuQv8T">
|
|
48
|
+
<img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
|
|
49
|
+
|
|
50
|
+
# Swarmauri Hyperbolic LLM
|
|
51
|
+
|
|
52
|
+
`swarmauri_llm_hyperbolic` provides provider-specific imports for Hyperbolic
|
|
53
|
+
inference in Swarmauri applications. The package exports text chat,
|
|
54
|
+
vision-language, and text-to-speech adapters while keeping implementation parity
|
|
55
|
+
with `swarmauri_standard`.
|
|
56
|
+
|
|
57
|
+
Hyperbolic's inference documentation describes OpenAI-compatible chat
|
|
58
|
+
completion APIs under `https://api.hyperbolic.xyz/v1/chat/completions`, model
|
|
59
|
+
catalog discovery under `/v1/models`, vision-language models that accept images
|
|
60
|
+
alongside text, and audio generation through `/v1/audio/generation`. This
|
|
61
|
+
package maps those provider surfaces into Swarmauri components:
|
|
62
|
+
|
|
63
|
+
- `HyperbolicModel` for OpenAI-compatible text chat completions.
|
|
64
|
+
- `HyperbolicVisionModel` for vision-language chat completions with image input.
|
|
65
|
+
- `HyperbolicAudioTTS` for text-to-speech audio generation.
|
|
66
|
+
|
|
67
|
+
## Why Use This Package?
|
|
68
|
+
|
|
69
|
+
- Keep Hyperbolic-specific inference imports explicit in Swarmauri applications.
|
|
70
|
+
- Use Swarmauri `Conversation` objects with Hyperbolic's OpenAI-compatible chat
|
|
71
|
+
and vision-language endpoints.
|
|
72
|
+
- Add text-to-speech generation without wiring raw base64 audio responses in
|
|
73
|
+
application code.
|
|
74
|
+
- Preserve a provider package boundary while relying on shared
|
|
75
|
+
`swarmauri_standard` runtime implementations.
|
|
76
|
+
|
|
77
|
+
## FAQ
|
|
78
|
+
|
|
79
|
+
### What does `swarmauri_llm_hyperbolic` install?
|
|
80
|
+
|
|
81
|
+
It installs provider package entry points for `HyperbolicModel`,
|
|
82
|
+
`HyperbolicVisionModel`, and `HyperbolicAudioTTS`.
|
|
83
|
+
|
|
84
|
+
### Which Hyperbolic endpoints does it use?
|
|
85
|
+
|
|
86
|
+
`HyperbolicModel` and `HyperbolicVisionModel` use Hyperbolic's
|
|
87
|
+
OpenAI-compatible `chat/completions` endpoint. `HyperbolicAudioTTS` posts to
|
|
88
|
+
`https://api.hyperbolic.xyz/v1/audio/generation` and writes the returned base64
|
|
89
|
+
audio payload to a local file.
|
|
90
|
+
|
|
91
|
+
### Does it support streaming?
|
|
92
|
+
|
|
93
|
+
`HyperbolicModel` supports synchronous and asynchronous streaming for chat
|
|
94
|
+
completion responses. `HyperbolicAudioTTS` does not support streaming and raises
|
|
95
|
+
`NotImplementedError` for `stream` and `astream`.
|
|
96
|
+
|
|
97
|
+
### Does it support vision-language prompts?
|
|
98
|
+
|
|
99
|
+
Yes. `HyperbolicVisionModel` accepts Swarmauri message content lists with text
|
|
100
|
+
and image input. Local image file paths can be converted to base64 data URLs by
|
|
101
|
+
the runtime helper.
|
|
102
|
+
|
|
103
|
+
### Is the TTS adapter a general LLM?
|
|
104
|
+
|
|
105
|
+
No. `HyperbolicAudioTTS` is a text-to-speech adapter kept in this provider
|
|
106
|
+
package for compatibility. The runtime deprecation warning points new projects
|
|
107
|
+
toward newer Swarmauri TTS imports when available.
|
|
108
|
+
|
|
109
|
+
## Features
|
|
110
|
+
|
|
111
|
+
- `HyperbolicModel` for sync, async, streaming, and batch chat completion
|
|
112
|
+
workflows.
|
|
113
|
+
- `HyperbolicVisionModel` for image-plus-text prompts against Hyperbolic VLMs.
|
|
114
|
+
- `HyperbolicAudioTTS` for synchronous and asynchronous text-to-speech
|
|
115
|
+
generation.
|
|
116
|
+
- Model discovery through Hyperbolic's `/models` endpoint.
|
|
117
|
+
- Generation controls including `temperature`, `max_tokens`, `top_p`, `top_k`,
|
|
118
|
+
and `stop`.
|
|
119
|
+
- Optional usage metadata handling on chat responses when available.
|
|
120
|
+
- Compatibility with Python 3.10, 3.11, 3.12, 3.13, and 3.14.
|
|
121
|
+
|
|
122
|
+
## Installation
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
uv add swarmauri_llm_hyperbolic
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
pip install swarmauri_llm_hyperbolic
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Prerequisites
|
|
133
|
+
|
|
134
|
+
Create a Hyperbolic API key in the Hyperbolic app and pass it to the model
|
|
135
|
+
constructor as `api_key=...`.
|
|
136
|
+
|
|
137
|
+
## Usage
|
|
138
|
+
|
|
139
|
+
```python
|
|
140
|
+
from swarmauri_llm_hyperbolic import HyperbolicModel
|
|
141
|
+
from swarmauri_standard.conversations.Conversation import Conversation
|
|
142
|
+
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
143
|
+
|
|
144
|
+
conversation = Conversation()
|
|
145
|
+
conversation.add_message(HumanMessage(content="Summarize this deployment risk."))
|
|
146
|
+
|
|
147
|
+
model = HyperbolicModel(api_key="HYPERBOLIC_API_KEY")
|
|
148
|
+
result = model.predict(conversation=conversation, max_tokens=200)
|
|
149
|
+
|
|
150
|
+
print(result.get_last().content)
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Streaming Chat
|
|
154
|
+
|
|
155
|
+
```python
|
|
156
|
+
from swarmauri_llm_hyperbolic import HyperbolicModel
|
|
157
|
+
from swarmauri_standard.conversations.Conversation import Conversation
|
|
158
|
+
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
159
|
+
|
|
160
|
+
conversation = Conversation()
|
|
161
|
+
conversation.add_message(HumanMessage(content="List three API gateway checks."))
|
|
162
|
+
|
|
163
|
+
model = HyperbolicModel(api_key="HYPERBOLIC_API_KEY")
|
|
164
|
+
|
|
165
|
+
for token in model.stream(conversation=conversation):
|
|
166
|
+
print(token, end="")
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
### Vision-Language Prompt
|
|
170
|
+
|
|
171
|
+
```python
|
|
172
|
+
from swarmauri_llm_hyperbolic import HyperbolicVisionModel
|
|
173
|
+
from swarmauri_standard.conversations.Conversation import Conversation
|
|
174
|
+
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
175
|
+
|
|
176
|
+
conversation = Conversation()
|
|
177
|
+
conversation.add_message(
|
|
178
|
+
HumanMessage(
|
|
179
|
+
content=[
|
|
180
|
+
{"type": "text", "text": "Describe the image."},
|
|
181
|
+
{"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}},
|
|
182
|
+
]
|
|
183
|
+
)
|
|
184
|
+
)
|
|
185
|
+
|
|
186
|
+
model = HyperbolicVisionModel(api_key="HYPERBOLIC_API_KEY")
|
|
187
|
+
result = model.predict(conversation=conversation)
|
|
188
|
+
|
|
189
|
+
print(result.get_last().content)
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### Text To Speech
|
|
193
|
+
|
|
194
|
+
```python
|
|
195
|
+
from swarmauri_llm_hyperbolic import HyperbolicAudioTTS
|
|
196
|
+
|
|
197
|
+
tts = HyperbolicAudioTTS(
|
|
198
|
+
api_key="HYPERBOLIC_API_KEY",
|
|
199
|
+
language="EN",
|
|
200
|
+
speaker="EN-US",
|
|
201
|
+
speed=1.0,
|
|
202
|
+
)
|
|
203
|
+
|
|
204
|
+
audio_path = tts.predict("Swarmauri turns model providers into components.")
|
|
205
|
+
print(audio_path)
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
## Related Packages
|
|
209
|
+
|
|
210
|
+
- [swarmauri_llm_deepinfra](https://pypi.org/project/swarmauri_llm_deepinfra/)
|
|
211
|
+
- [swarmauri_llm_groq](https://pypi.org/project/swarmauri_llm_groq/)
|
|
212
|
+
- [swarmauri_llm_mistral](https://pypi.org/project/swarmauri_llm_mistral/)
|
|
213
|
+
- [swarmauri_llm_openai](https://pypi.org/project/swarmauri_llm_openai/)
|
|
214
|
+
- [swarmauri_llm_perplexity](https://pypi.org/project/swarmauri_llm_perplexity/)
|
|
215
|
+
- [swarmauri_llm_playht](https://pypi.org/project/swarmauri_llm_playht/)
|
|
216
|
+
|
|
217
|
+
## Foundational Swarmauri Packages
|
|
218
|
+
|
|
219
|
+
- [swarmauri_core](https://pypi.org/project/swarmauri_core/)
|
|
220
|
+
- [swarmauri_base](https://pypi.org/project/swarmauri_base/)
|
|
221
|
+
- [swarmauri_standard](https://pypi.org/project/swarmauri_standard/)
|
|
222
|
+
- [swarmauri](https://pypi.org/project/swarmauri/)
|
|
223
|
+
|
|
224
|
+
## Provider Documentation
|
|
225
|
+
|
|
226
|
+
- [Hyperbolic quick start](https://www.hyperbolic.ai/docs/inference/quickstart)
|
|
227
|
+
- [Hyperbolic text generation APIs](https://www.hyperbolic.ai/docs/inference/text-apis)
|
|
228
|
+
- [Hyperbolic vision-language APIs](https://www.hyperbolic.ai/docs/inference/vlm-apis)
|
|
229
|
+
- [Hyperbolic supported models](https://docs.hyperbolic.xyz/docs/supported-models)
|
|
230
|
+
|
|
231
|
+
## Best Practices
|
|
232
|
+
|
|
233
|
+
- Store Hyperbolic API keys in environment variables or a secrets manager.
|
|
234
|
+
- Confirm model availability and provider capability flags before production
|
|
235
|
+
deployment.
|
|
236
|
+
- Use `HyperbolicVisionModel` only for image-aware prompts; plain chat is simpler
|
|
237
|
+
with `HyperbolicModel`.
|
|
238
|
+
- Use explicit output paths for TTS generation so generated audio files are easy
|
|
239
|
+
to manage.
|
|
240
|
+
- Prefer newer Swarmauri VLM and TTS imports for new projects when available.
|
|
241
|
+
|
|
242
|
+
## License
|
|
243
|
+
|
|
244
|
+
Apache-2.0
|
|
245
|
+
|
|
246
|
+
|
|
247
|
+
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+

|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://pepy.tech/project/swarmauri_llm_hyperbolic/">
|
|
5
|
+
<img src="https://static.pepy.tech/badge/swarmauri_llm_hyperbolic/month" alt="PyPI - Downloads"/></a>
|
|
6
|
+
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_hyperbolic/">
|
|
7
|
+
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_hyperbolic.svg"/></a>
|
|
8
|
+
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
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_hyperbolic/">
|
|
11
|
+
<img src="https://img.shields.io/pypi/l/swarmauri_llm_hyperbolic" alt="PyPI - License"/></a>
|
|
12
|
+
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
13
|
+
<img src="https://img.shields.io/pypi/v/swarmauri_llm_hyperbolic?label=swarmauri_llm_hyperbolic&color=green" alt="PyPI - swarmauri_llm_hyperbolic"/></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 Hyperbolic LLM
|
|
18
|
+
|
|
19
|
+
`swarmauri_llm_hyperbolic` provides provider-specific imports for Hyperbolic
|
|
20
|
+
inference in Swarmauri applications. The package exports text chat,
|
|
21
|
+
vision-language, and text-to-speech adapters while keeping implementation parity
|
|
22
|
+
with `swarmauri_standard`.
|
|
23
|
+
|
|
24
|
+
Hyperbolic's inference documentation describes OpenAI-compatible chat
|
|
25
|
+
completion APIs under `https://api.hyperbolic.xyz/v1/chat/completions`, model
|
|
26
|
+
catalog discovery under `/v1/models`, vision-language models that accept images
|
|
27
|
+
alongside text, and audio generation through `/v1/audio/generation`. This
|
|
28
|
+
package maps those provider surfaces into Swarmauri components:
|
|
29
|
+
|
|
30
|
+
- `HyperbolicModel` for OpenAI-compatible text chat completions.
|
|
31
|
+
- `HyperbolicVisionModel` for vision-language chat completions with image input.
|
|
32
|
+
- `HyperbolicAudioTTS` for text-to-speech audio generation.
|
|
33
|
+
|
|
34
|
+
## Why Use This Package?
|
|
35
|
+
|
|
36
|
+
- Keep Hyperbolic-specific inference imports explicit in Swarmauri applications.
|
|
37
|
+
- Use Swarmauri `Conversation` objects with Hyperbolic's OpenAI-compatible chat
|
|
38
|
+
and vision-language endpoints.
|
|
39
|
+
- Add text-to-speech generation without wiring raw base64 audio responses in
|
|
40
|
+
application code.
|
|
41
|
+
- Preserve a provider package boundary while relying on shared
|
|
42
|
+
`swarmauri_standard` runtime implementations.
|
|
43
|
+
|
|
44
|
+
## FAQ
|
|
45
|
+
|
|
46
|
+
### What does `swarmauri_llm_hyperbolic` install?
|
|
47
|
+
|
|
48
|
+
It installs provider package entry points for `HyperbolicModel`,
|
|
49
|
+
`HyperbolicVisionModel`, and `HyperbolicAudioTTS`.
|
|
50
|
+
|
|
51
|
+
### Which Hyperbolic endpoints does it use?
|
|
52
|
+
|
|
53
|
+
`HyperbolicModel` and `HyperbolicVisionModel` use Hyperbolic's
|
|
54
|
+
OpenAI-compatible `chat/completions` endpoint. `HyperbolicAudioTTS` posts to
|
|
55
|
+
`https://api.hyperbolic.xyz/v1/audio/generation` and writes the returned base64
|
|
56
|
+
audio payload to a local file.
|
|
57
|
+
|
|
58
|
+
### Does it support streaming?
|
|
59
|
+
|
|
60
|
+
`HyperbolicModel` supports synchronous and asynchronous streaming for chat
|
|
61
|
+
completion responses. `HyperbolicAudioTTS` does not support streaming and raises
|
|
62
|
+
`NotImplementedError` for `stream` and `astream`.
|
|
63
|
+
|
|
64
|
+
### Does it support vision-language prompts?
|
|
65
|
+
|
|
66
|
+
Yes. `HyperbolicVisionModel` accepts Swarmauri message content lists with text
|
|
67
|
+
and image input. Local image file paths can be converted to base64 data URLs by
|
|
68
|
+
the runtime helper.
|
|
69
|
+
|
|
70
|
+
### Is the TTS adapter a general LLM?
|
|
71
|
+
|
|
72
|
+
No. `HyperbolicAudioTTS` is a text-to-speech adapter kept in this provider
|
|
73
|
+
package for compatibility. The runtime deprecation warning points new projects
|
|
74
|
+
toward newer Swarmauri TTS imports when available.
|
|
75
|
+
|
|
76
|
+
## Features
|
|
77
|
+
|
|
78
|
+
- `HyperbolicModel` for sync, async, streaming, and batch chat completion
|
|
79
|
+
workflows.
|
|
80
|
+
- `HyperbolicVisionModel` for image-plus-text prompts against Hyperbolic VLMs.
|
|
81
|
+
- `HyperbolicAudioTTS` for synchronous and asynchronous text-to-speech
|
|
82
|
+
generation.
|
|
83
|
+
- Model discovery through Hyperbolic's `/models` endpoint.
|
|
84
|
+
- Generation controls including `temperature`, `max_tokens`, `top_p`, `top_k`,
|
|
85
|
+
and `stop`.
|
|
86
|
+
- Optional usage metadata handling on chat responses when available.
|
|
87
|
+
- Compatibility with Python 3.10, 3.11, 3.12, 3.13, and 3.14.
|
|
88
|
+
|
|
89
|
+
## Installation
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
uv add swarmauri_llm_hyperbolic
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
pip install swarmauri_llm_hyperbolic
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Prerequisites
|
|
100
|
+
|
|
101
|
+
Create a Hyperbolic API key in the Hyperbolic app and pass it to the model
|
|
102
|
+
constructor as `api_key=...`.
|
|
103
|
+
|
|
104
|
+
## Usage
|
|
105
|
+
|
|
106
|
+
```python
|
|
107
|
+
from swarmauri_llm_hyperbolic import HyperbolicModel
|
|
108
|
+
from swarmauri_standard.conversations.Conversation import Conversation
|
|
109
|
+
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
110
|
+
|
|
111
|
+
conversation = Conversation()
|
|
112
|
+
conversation.add_message(HumanMessage(content="Summarize this deployment risk."))
|
|
113
|
+
|
|
114
|
+
model = HyperbolicModel(api_key="HYPERBOLIC_API_KEY")
|
|
115
|
+
result = model.predict(conversation=conversation, max_tokens=200)
|
|
116
|
+
|
|
117
|
+
print(result.get_last().content)
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Streaming Chat
|
|
121
|
+
|
|
122
|
+
```python
|
|
123
|
+
from swarmauri_llm_hyperbolic import HyperbolicModel
|
|
124
|
+
from swarmauri_standard.conversations.Conversation import Conversation
|
|
125
|
+
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
126
|
+
|
|
127
|
+
conversation = Conversation()
|
|
128
|
+
conversation.add_message(HumanMessage(content="List three API gateway checks."))
|
|
129
|
+
|
|
130
|
+
model = HyperbolicModel(api_key="HYPERBOLIC_API_KEY")
|
|
131
|
+
|
|
132
|
+
for token in model.stream(conversation=conversation):
|
|
133
|
+
print(token, end="")
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### Vision-Language Prompt
|
|
137
|
+
|
|
138
|
+
```python
|
|
139
|
+
from swarmauri_llm_hyperbolic import HyperbolicVisionModel
|
|
140
|
+
from swarmauri_standard.conversations.Conversation import Conversation
|
|
141
|
+
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
142
|
+
|
|
143
|
+
conversation = Conversation()
|
|
144
|
+
conversation.add_message(
|
|
145
|
+
HumanMessage(
|
|
146
|
+
content=[
|
|
147
|
+
{"type": "text", "text": "Describe the image."},
|
|
148
|
+
{"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}},
|
|
149
|
+
]
|
|
150
|
+
)
|
|
151
|
+
)
|
|
152
|
+
|
|
153
|
+
model = HyperbolicVisionModel(api_key="HYPERBOLIC_API_KEY")
|
|
154
|
+
result = model.predict(conversation=conversation)
|
|
155
|
+
|
|
156
|
+
print(result.get_last().content)
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
### Text To Speech
|
|
160
|
+
|
|
161
|
+
```python
|
|
162
|
+
from swarmauri_llm_hyperbolic import HyperbolicAudioTTS
|
|
163
|
+
|
|
164
|
+
tts = HyperbolicAudioTTS(
|
|
165
|
+
api_key="HYPERBOLIC_API_KEY",
|
|
166
|
+
language="EN",
|
|
167
|
+
speaker="EN-US",
|
|
168
|
+
speed=1.0,
|
|
169
|
+
)
|
|
170
|
+
|
|
171
|
+
audio_path = tts.predict("Swarmauri turns model providers into components.")
|
|
172
|
+
print(audio_path)
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## Related Packages
|
|
176
|
+
|
|
177
|
+
- [swarmauri_llm_deepinfra](https://pypi.org/project/swarmauri_llm_deepinfra/)
|
|
178
|
+
- [swarmauri_llm_groq](https://pypi.org/project/swarmauri_llm_groq/)
|
|
179
|
+
- [swarmauri_llm_mistral](https://pypi.org/project/swarmauri_llm_mistral/)
|
|
180
|
+
- [swarmauri_llm_openai](https://pypi.org/project/swarmauri_llm_openai/)
|
|
181
|
+
- [swarmauri_llm_perplexity](https://pypi.org/project/swarmauri_llm_perplexity/)
|
|
182
|
+
- [swarmauri_llm_playht](https://pypi.org/project/swarmauri_llm_playht/)
|
|
183
|
+
|
|
184
|
+
## Foundational Swarmauri Packages
|
|
185
|
+
|
|
186
|
+
- [swarmauri_core](https://pypi.org/project/swarmauri_core/)
|
|
187
|
+
- [swarmauri_base](https://pypi.org/project/swarmauri_base/)
|
|
188
|
+
- [swarmauri_standard](https://pypi.org/project/swarmauri_standard/)
|
|
189
|
+
- [swarmauri](https://pypi.org/project/swarmauri/)
|
|
190
|
+
|
|
191
|
+
## Provider Documentation
|
|
192
|
+
|
|
193
|
+
- [Hyperbolic quick start](https://www.hyperbolic.ai/docs/inference/quickstart)
|
|
194
|
+
- [Hyperbolic text generation APIs](https://www.hyperbolic.ai/docs/inference/text-apis)
|
|
195
|
+
- [Hyperbolic vision-language APIs](https://www.hyperbolic.ai/docs/inference/vlm-apis)
|
|
196
|
+
- [Hyperbolic supported models](https://docs.hyperbolic.xyz/docs/supported-models)
|
|
197
|
+
|
|
198
|
+
## Best Practices
|
|
199
|
+
|
|
200
|
+
- Store Hyperbolic API keys in environment variables or a secrets manager.
|
|
201
|
+
- Confirm model availability and provider capability flags before production
|
|
202
|
+
deployment.
|
|
203
|
+
- Use `HyperbolicVisionModel` only for image-aware prompts; plain chat is simpler
|
|
204
|
+
with `HyperbolicModel`.
|
|
205
|
+
- Use explicit output paths for TTS generation so generated audio files are easy
|
|
206
|
+
to manage.
|
|
207
|
+
- Prefer newer Swarmauri VLM and TTS imports for new projects when available.
|
|
208
|
+
|
|
209
|
+
## License
|
|
210
|
+
|
|
211
|
+
Apache-2.0
|
|
212
|
+
|
|
213
|
+
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "swarmauri_llm_hyperbolic"
|
|
3
|
-
version = "0.
|
|
4
|
-
description = "Swarmauri Hyperbolic
|
|
3
|
+
version = "0.11.0.dev1"
|
|
4
|
+
description = "Provider-specific Swarmauri import package for Hyperbolic OpenAI-compatible chat, vision-language inference, streaming, and text-to-speech workflows."
|
|
5
5
|
license = "Apache-2.0"
|
|
6
6
|
readme = "README.md"
|
|
7
7
|
repository = "http://github.com/swarmauri/swarmauri-sdk"
|
|
@@ -11,6 +11,11 @@ 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 :: Scientific/Engineering :: Artificial Intelligence",
|
|
18
|
+
"Topic :: Software Development :: Libraries",
|
|
14
19
|
"Topic :: Software Development :: Libraries :: Application Frameworks",
|
|
15
20
|
"Programming Language :: Python",
|
|
16
21
|
"Programming Language :: Python :: 3",
|
|
@@ -31,7 +36,24 @@ keywords = [
|
|
|
31
36
|
"swarmauri",
|
|
32
37
|
"llm",
|
|
33
38
|
"hyperbolic",
|
|
39
|
+
"hyperbolic api",
|
|
40
|
+
"openai compatible",
|
|
41
|
+
"chat completions",
|
|
42
|
+
"vision language model",
|
|
43
|
+
"vlm",
|
|
44
|
+
"text to speech",
|
|
45
|
+
"tts",
|
|
46
|
+
"audio generation",
|
|
47
|
+
"streaming llm",
|
|
48
|
+
"async llm",
|
|
49
|
+
"qwen",
|
|
50
|
+
"llama",
|
|
51
|
+
"deepseek",
|
|
52
|
+
"large language model",
|
|
53
|
+
"generative ai",
|
|
54
|
+
"swarmauri llm",
|
|
34
55
|
"model",
|
|
56
|
+
"composable intelligence",
|
|
35
57
|
]
|
|
36
58
|
|
|
37
59
|
[tool.uv.sources]
|
|
@@ -75,7 +97,7 @@ dev = [
|
|
|
75
97
|
"pytest-xdist>=3.6.1",
|
|
76
98
|
"pytest-json-report>=1.5.0",
|
|
77
99
|
"python-dotenv",
|
|
78
|
-
"
|
|
100
|
+
"httpx>=0.27",
|
|
79
101
|
"flake8>=7.0",
|
|
80
102
|
"pytest-timeout>=2.3.1",
|
|
81
103
|
"ruff>=0.9.9",
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: swarmauri_llm_hyperbolic
|
|
3
|
-
Version: 0.1.1.dev3
|
|
4
|
-
Summary: Swarmauri Hyperbolic LLM adapters from swarmauri_standard.
|
|
5
|
-
License-Expression: Apache-2.0
|
|
6
|
-
License-File: LICENSE
|
|
7
|
-
Keywords: swarmauri,llm,hyperbolic,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_hyperbolic/">
|
|
33
|
-
<img src="https://static.pepy.tech/badge/swarmauri_llm_hyperbolic/month" alt="PyPI - Downloads"/></a>
|
|
34
|
-
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_hyperbolic/">
|
|
35
|
-
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_llm_hyperbolic.svg"/></a>
|
|
36
|
-
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
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_hyperbolic/">
|
|
39
|
-
<img src="https://img.shields.io/pypi/l/swarmauri_llm_hyperbolic" alt="PyPI - License"/></a>
|
|
40
|
-
<a href="https://pypi.org/project/swarmauri_llm_hyperbolic/">
|
|
41
|
-
<img src="https://img.shields.io/pypi/v/swarmauri_llm_hyperbolic?label=swarmauri_llm_hyperbolic&color=green" alt="PyPI - swarmauri_llm_hyperbolic"/></a>
|
|
42
|
-
</p>
|
|
43
|
-
|
|
44
|
-
# swarmauri_llm_hyperbolic
|
|
45
|
-
|
|
46
|
-
Provider-specific Hyperbolic LLM package for Swarmauri. This package offers direct imports for HyperbolicAudioTTS, HyperbolicModel, HyperbolicVisionModel while keeping implementation parity with `swarmauri_standard`.
|
|
47
|
-
|
|
48
|
-
## Features
|
|
49
|
-
|
|
50
|
-
- `HyperbolicAudioTTS` adapter exported from `swarmauri_standard.llms.HyperbolicAudioTTS`.
|
|
51
|
-
- `HyperbolicModel` adapter exported from `swarmauri_standard.llms.HyperbolicModel`.
|
|
52
|
-
- `HyperbolicVisionModel` adapter exported from `swarmauri_standard.llms.HyperbolicVisionModel`.
|
|
53
|
-
- Compatible with Python 3.10 through 3.12.
|
|
54
|
-
|
|
55
|
-
## Installation
|
|
56
|
-
|
|
57
|
-
```bash
|
|
58
|
-
# uv
|
|
59
|
-
uv add swarmauri_llm_hyperbolic
|
|
60
|
-
|
|
61
|
-
# pip
|
|
62
|
-
pip install swarmauri_llm_hyperbolic
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
## Usage
|
|
66
|
-
|
|
67
|
-
```python
|
|
68
|
-
from swarmauri_llm_hyperbolic import HyperbolicAudioTTS
|
|
69
|
-
from swarmauri_llm_hyperbolic import HyperbolicModel
|
|
70
|
-
from swarmauri_llm_hyperbolic import HyperbolicVisionModel
|
|
71
|
-
from swarmauri_standard.conversations.Conversation import Conversation
|
|
72
|
-
from swarmauri_standard.messages.HumanMessage import HumanMessage
|
|
73
|
-
|
|
74
|
-
conversation = Conversation()
|
|
75
|
-
conversation.add_message(HumanMessage(content="Hello from Swarmauri"))
|
|
76
|
-
|
|
77
|
-
model = HyperbolicAudioTTS()
|
|
78
|
-
# Configure provider credentials before making requests.
|
|
79
|
-
# result = model.predict(conversation=conversation)
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
## Workflow Notes
|
|
83
|
-
|
|
84
|
-
- These adapters intentionally mirror the corresponding classes in `swarmauri_standard`.
|
|
85
|
-
- Use the provider package that matches your deployment and credential setup.
|
|
86
|
-
- Install only the provider packages you need to keep dependencies minimal.
|
|
87
|
-
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-

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