← all repositories
gradio-app/gradio

Python-only web UIs for ML demos, no frontend skills required

Gradio wraps any Python function in a shareable web interface so you can stop explaining your model and let people break it themselves.

42.8k stars Python App BuildersInference · Serving
gradio
Velocity · 7d
+16
★ / day
Trend
steady
star history

What it does Gradio is a Python library that generates a web UI around any function you hand it—text, images, sliders, whatever. You write Python; it handles the browser, the layout, and even temporary public hosting via share=True. It runs in notebooks, scripts, or Colab without you touching JavaScript or CSS.

The interesting bit The gr.Interface class is almost insultingly simple: pass it a function, a list of input components, and a list of output components. But underneath, it is doing the tedious wiring—type coercion, file upload handling, async queueing—that usually eats an afternoon. For more control, gr.Blocks lets you build complex multi-step apps (the Automatic1111 Stable Diffusion UI uses this) while still staying in Python.

Key highlights

  • 30+ built-in components including text, image, audio, video, and dataframes
  • One-line sharing: demo.launch(share=True) spins up a public .gradio.live URL in seconds, tunneling from your local machine
  • Hot reload and “vibe mode”: gradio app.py auto-reloads on save; --vibe adds an in-browser AI assistant to edit your app with natural language
  • ChatInterface: a dedicated high-level class for chatbot UIs, because everyone is building chatbots now
  • Ecosystem: Python and JavaScript clients for querying apps programmatically, plus a gradio.Server mode if you want to bring your own frontend
  • AI coding skills: gradio skills add --cursor (or --claude, --codex) injects Gradio-specific knowledge into your coding assistant

Caveats

  • Requires Python 3.10+; no support for older versions
  • The free temporary sharing URLs are, well, temporary—production hosting means moving to Hugging Face Spaces or self-hosting
  • The README mentions “vibe mode” but does not clarify what model powers it or whether it phones home

Verdict If you have a model or API and need to let teammates or Twitter strangers poke at it today, Gradio is the fastest path. If you are building a polished consumer product with custom design and auth, you will outgrow it and should plan to graduate to a real frontend framework.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.