hf-gradio
An extension of the Hugging Face CLI for interacting with Gradio Spaces and Apps.
Decision gist · record as of 2026-08-14
Yes, if you need to interact with Gradio Spaces from the command line or want to integrate them into scripts and agent workflows. The tool is actively maintained, has low install friction, and carries no security vulnerabilities. The MIT license poses no restrictions. However, the project is very new (first release in March 2026) with minimal community adoption (3 GitHub stars), so expect possible API changes and limited third-party documentation.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- The target Gradio Space must be publicly accessible or you must provide a valid HF token via --token for private spaces.
- Low friction install with only two runtime dependencies (gradio-client and typer).
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2026-04-17 (119 days) · last repo commit 2026-04-21 · 3 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,931,311 downloads/mo, #2,446 on PyPI
Alternatives
Verify before relying
pip install hf-gradio
# Discover endpoints
hf-gradio info gradio/calculator
# Send a prediction
hf-gradio predict gradio/calculator /predict '{"num1": 5, "operation": "multiply", "num2": 3}'- Whether the tool works reliably with all Gradio app types or has known limitations with certain component types.
- Performance characteristics when calling endpoints with large file uploads or long-running predictions.
- Whether error handling and retry logic are documented for network failures or rate limiting.
What it is and what it does
hf-gradio is a command-line interface for interacting with Gradio applications running on Hugging Face Spaces. It provides two main commands: `info` returns a JSON schema describing all available endpoints, their parameters (with types, defaults, and requirements), and return values; `predict` sends JSON payloads to those endpoints and returns results. The tool handles file uploads by requiring a specific metadata structure and supports authentication via HF tokens for private spaces. It's designed to be agent-friendly, with schemas structured so that AI coding agents can discover APIs and construct valid payloads programmatically.
The package depends on gradio-client for API communication and typer for CLI argument parsing. It requires Python 3.10 or later. The tool works both as a standalone CLI command and integrates with the Gradio package when installed, exposing `gradio info` and `gradio predict` subcommands.
Use it for
- Discover available endpoints and parameter schemas for a Gradio Space before writing client code.
- Send predictions to image generation or data processing Gradio apps from shell scripts or CI/CD pipelines.
- Enable AI agents to autonomously discover and call Gradio APIs by parsing the JSON schema output.
- Upload files to Gradio endpoints that accept file inputs, with automatic metadata formatting.
- Access private Gradio Spaces using HF authentication tokens from the command line.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to interact with Gradio Spaces from the command line or want to integrate them into scripts and agent workflows.
The tool is actively maintained, has low install friction, and carries no security vulnerabilities. The MIT license poses no restrictions. However, the project is very new (first release in March 2026) with minimal community adoption (3 GitHub stars), so expect possible API changes and limited third-party documentation.
Install
hf-gradio on PyPI
Before you install
Low friction install with only two runtime dependencies (gradio-client and typer). Active maintenance as of 2026-04-21 with recent releases, though the project is young (first release 2026-03-19) and has minimal GitHub presence (3 stars).
Requires Python 3.10 or later. The target Gradio Space must be publicly accessible or you must provide a valid HF token via --token for private spaces.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
pip install hf-gradio
# Discover endpoints
hf-gradio info gradio/calculator
# Send a prediction
hf-gradio predict gradio/calculator /predict '{"num1": 5, "operation": "multiply", "num2": 3}'Verify before relying
- Whether the tool works reliably with all Gradio app types or has known limitations with certain component types.
- Performance characteristics when calling endpoints with large file uploads or long-running predictions.
- Whether error handling and retry logic are documented for network failures or rate limiting.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesgradio-clienttyper |
| Maintenance | Actively maintained 119 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,931,311 / month, #2,446 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: hf_gradio-0.4.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “gradio cli predict”
- hf-gradioA CLI tool for discovering endpoints and sending predictions to…
- gradio-clientCalls any Gradio app as a Python API with a simple Client interface,…
- gradio-pdfProvides a PDF display component for Gradio applications, allowing…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also gradio-client · spaces · hf · gradio-imageslider · huggingface-hub · gradio · gradio-rangeslider · gradio-pdf · hf-transfer · text-generation