---
id: gradio
version: "6.24.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# gradio — Python library for easily interacting with trained machine learning models

License: permissive · Maintenance: active · Downloads: 18.4M/mo

## What it is and what it does

Gradio is a Python framework that wraps machine learning models, APIs, or arbitrary Python functions into interactive web applications with minimal code. It provides high-level classes like Interface for simple demos, Blocks for custom layouts and complex workflows, and ChatInterface for chatbot UIs. The framework handles the entire web stack—FastAPI backend, Starlette routing, and frontend rendering—so developers write only Python. Once built, demos can be shared instantly via public URLs using Gradio's built-in sharing feature, allowing anyone to interact with the application from a browser while computation runs locally.

The package depends on a substantial ecosystem: FastAPI and Uvicorn for the web server, Pydantic for validation, Pillow and NumPy for media handling, Hugging Face Hub for model integration, and several utility libraries. It supports Python 3.10 through 3.13 and is classified as Production/Stable. The framework is actively maintained with frequent releases and strong community adoption (top 5000 PyPI packages by downloads).

Use it for:

- Quickly prototype and demo a trained machine learning model without building a custom web application.
- Share a data analysis or visualization tool with collaborators or stakeholders via a public link.
- Build a chatbot interface for a language model or conversational API in a few lines of Python.
- Create an interactive form-based tool for any Python function (e.g., tax calculator, image processor).
- Deploy a complex multi-step workflow with custom layouts and conditional logic using Blocks.
- Integrate with Hugging Face Hub to showcase models directly from the model card.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Gradio builds web interfaces for machine learning models, APIs, and Python functions without requiring JavaScript or web hosting knowledge, then shares them via public URLs.

Yes. Gradio is worth installing if you need to build and share web interfaces for ML models or Python functions without web development expertise. It has low install friction, active maintenance, a permissive license, no known vulnerabilities, and strong adoption. The only consideration is the substantial dependency footprint (28 runtime packages) and the Python 3.10+ requirement; if your environment is constrained, verify compatibility first.

## Install

pip install gradio
uv add gradio
poetry add gradio

## Installing gradio

Before you install: Low install friction with a pure Python wheel distribution. Active maintenance with a release 2 days old and 43364 repository stars. Requires Python 3.10 or higher and pulls in 28 runtime dependencies including fastapi, uvicorn, and huggingface-hub.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for both open-source and proprietary projects.

Quickstart:

pip install gradio

import gradio as gr

def greet(name):
    return "Hello " + name + "!"

demo = gr.Interface(fn=greet, inputs="textbox", outputs="textbox")
demo.launch()

Requires Python 3.10 or higher.

Verify before relying:

- Whether the 30+ built-in components mentioned in the description are all documented and stable in version 6.24.0.
- Performance characteristics when handling concurrent users or large file uploads through shared links.
- Compatibility of the hot-reload and vibe mode features with different development environments.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 18.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

machine learning web ui builder, python ml demo framework, quick ml model interface, shareable ml web app, no-code ml interface, python function to web ui, ml model demo sharing, ml-demo, web-ui-builder, no-code-interface

[View on SkillFed](https://skillfed.io/packages/gradio) · [View on PyPI](https://pypi.org/project/gradio/)