hedron-gradio
Production-grade Gradio client interoperability for Hedron.
Endpoint discovery, allowlisted remote calls, predict / job / stream helpers with explicit schemas, bounded file transport, and Hugging Face vendor-node adapters — without embedding Gradio’s UI runtime in core. Disabled by default; absence of this package adds no core dependency or startup cost.
Also available as the flagship extra hedron[gradio].
Package maturity: Beta · Train: 0.2.x · pin >=0.2.0,<0.3
Install
pip install "hedron-gradio>=0.2.3,<0.3"
# or
uv add "hedron-gradio>=0.2.0,<0.3"
# via flagship extra:
pip install "hedron[gradio]>=1.0.0,<1.1"
Requires Python 3.10–3.14.
For live Gradio endpoints, also install gradio_client. The package imports
without gradio or gradio_client installed; with declared endpoints and no
client library, helpers return stub-friendly status payloads.
Quick start
from hedron_gradio import GradioClientAdapter, GradioEndpoint, GradioRemoteConfig
config = GradioRemoteConfig.from_base_url("https://example.gradio.live")
adapter = GradioClientAdapter(
base_url=config.base_url,
enabled=True,
remote_config=config,
endpoints=(GradioEndpoint(name="predict", api_name="/predict", parameters={}),),
)
endpoints = adapter.discover()
result = adapter.predict("predict", {"text": "hi"})
With enabled=False (the default), discover() returns empty.
Public API
| Symbol | Role |
|---|---|
GradioRemoteConfig |
Allowlisted destination policy |
GradioClientAdapter |
Discovery, predict, jobs, streams, file transfer |
GradioEndpoint |
Declared endpoint metadata |
GradioRemoteError |
Remote failure signal |
HuggingFaceVendorNode / hf_space_node |
HF Space vendor helpers |
Links
License
MIT. See the repository license.
Release files for hedron-gradio 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hedron_gradio-0.2.3.tar.gz | 15.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hedron_gradio-0.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.8 kB
Release files / hedron_gradio-0.2.3.tar.gz
| Download URL | hedron_gradio-0.2.3.tar.gz |
|---|---|
| Size | 15.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40d27be018b1feb4d3806baa0a62e9d01ce26574769b36eb76a023e2e5afb711
|
|
BLAKE2b-256 checksum How to use checksums |
a18ae2cbe0b15b60b787108fe0b9fa48672298e5752263da1bcee4648227cc5f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","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 / hedron_gradio-0.2.3-py3-none-any.whl
| Download URL | hedron_gradio-0.2.3-py3-none-any.whl |
|---|---|
| Size | 18.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
77ba4fc2f3fb2dc688e00bcbd677dffb3fe256f244c62b2a567c5f12c7c39dcb
|
|
BLAKE2b-256 checksum How to use checksums |
8bd959f82b7cc53e335952653276ac81366c675dde7911aeeb802646f587bd38
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","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}
|