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.0,<0.3"
# or
uv add "hedron-gradio>=0.2.0,<0.3"
# via flagship extra:
pip install "hedron[gradio]>=0.61.0,<0.62"

Requires Python 3.11–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

Links

• Package docs
• Gradio migration guide
• What's new in 0.34
• Changelog
• Source
• Issues

License

MIT. See the repository license.