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"

Requires Python 3.10–3.14.

Hedron does not automatically construct gradio_client.Client: that library does not expose the connection-bound transport needed to prevent DNS rebinding. Use declared endpoints for offline/stub behavior, or provide an application-owned transport that routes its HTTP through hedron_core.fetch_with_policy.

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.