lmux-groq
Groq provider for lmux. Talks to the Groq Chat Completions API directly over httpx.
Supports chat completions and streaming.
Part of the lmux ecosystem: standardized interface, cost tracking on every response, and registry-based routing across providers.
Auth
Set GROQ_API_KEY in your environment. The default GroqEnvAuthProvider reads it automatically.
from lmux_groq import GroqProvider
provider = GroqProvider()
Usage
Chat
from lmux import UserMessage
response = provider.chat("llama-3.3-70b-versatile", [UserMessage(content="Hello")])
print(response.content)
print(response.cost)
Streaming
for chunk in provider.chat_stream("llama-3.3-70b-versatile", [UserMessage(content="Hello")]):
if chunk.delta:
print(chunk.delta, end="")
Async
All methods have async variants: achat, achat_stream.
Registry
Use with the lmux registry to route across multiple providers:
from lmux import Registry
registry = Registry()
registry.register("groq", provider)
response = registry.chat("groq/llama-3.3-70b-versatile", messages)
Provider Params
from lmux_groq import GroqParams
response = provider.chat(
"llama-3.3-70b-versatile",
messages,
provider_params=GroqParams(service_tier="flex"),
)
| Parameter | Type | Description |
|---|---|---|
service_tier |
"auto" | "on_demand" | "flex" | "performance" |
Service tier selection |
seed |
int |
Deterministic sampling seed |
user |
str |
End-user identifier |
Constructor Options
GroqProvider(
auth=..., # AuthProvider[str], default: GroqEnvAuthProvider()
base_url=..., # Optional base URL override
timeout=..., # Request timeout in seconds
max_retries=..., # Max retry attempts
default_headers=..., # Optional headers included with every request
transport=..., # Optional httpx.BaseTransport for the sync client (proxies, testing)
async_transport=..., # Optional httpx.AsyncBaseTransport for the async client
)
default_headers is useful for gateway authentication, tracing, and routing. Groq-managed authorization and
content-type headers take precedence over caller values, case-insensitively.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lmux_groq-0.8.0.tar.gz.
File metadata
- Download URL: lmux_groq-0.8.0.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32a6117a52a8cac86ed4c56829e00269a443a745da3ae2c6808f99c020661237
|
|
| MD5 |
1b7b46f3ecbcc0aa055d078868d52c1f
|
|
| BLAKE2b-256 |
5baff116485cc5d33bd3aa8164005fd12263bcb5de6d9cf7127214f704143045
|
Provenance
The following attestation bundles were made for lmux_groq-0.8.0.tar.gz:
Publisher:
publish.yml on cluebbehusen/lmux
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lmux_groq-0.8.0.tar.gz -
Subject digest:
32a6117a52a8cac86ed4c56829e00269a443a745da3ae2c6808f99c020661237 - Sigstore transparency entry: 2306938999
- Sigstore integration time:
-
Permalink:
cluebbehusen/lmux@c330796afb2e901072be42c1b674ec37e9713307 -
Branch / Tag:
refs/tags/lmux-groq-v0.8.0 - Owner: https://github.com/cluebbehusen
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c330796afb2e901072be42c1b674ec37e9713307 -
Trigger Event:
push
-
Statement type:
File details
Details for the file lmux_groq-0.8.0-py3-none-any.whl.
File metadata
- Download URL: lmux_groq-0.8.0-py3-none-any.whl
- Upload date:
- Size: 12.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
37139540322558b8e11777ea419d987d57d4593a1ae704e06dd10a0da7821dc8
|
|
| MD5 |
ec75faafc6a05d90131f9ece12b41dbe
|
|
| BLAKE2b-256 |
aafbf27b1aa77b6b0cec6110617c873af3cefdb58a0e7387ebde3aafdb50bebe
|
Provenance
The following attestation bundles were made for lmux_groq-0.8.0-py3-none-any.whl:
Publisher:
publish.yml on cluebbehusen/lmux
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lmux_groq-0.8.0-py3-none-any.whl -
Subject digest:
37139540322558b8e11777ea419d987d57d4593a1ae704e06dd10a0da7821dc8 - Sigstore transparency entry: 2306939015
- Sigstore integration time:
-
Permalink:
cluebbehusen/lmux@c330796afb2e901072be42c1b674ec37e9713307 -
Branch / Tag:
refs/tags/lmux-groq-v0.8.0 - Owner: https://github.com/cluebbehusen
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c330796afb2e901072be42c1b674ec37e9713307 -
Trigger Event:
push
-
Statement type:
