Gradio：用 Python 几行代码，给模型搭个 Web 界面

Gradio 在 GitHub 上拿到了 42,892 Star。

开源 Python 包，干的事很明确：给机器学习模型、API、或者任意 Python 函数套一个 Web 界面。不用写 JavaScript，不用碰 CSS，不用折腾部署。

1、这玩意儿是干嘛的

一句话：写一个 Python 函数，Gradio 给它加上浏览器界面。

输入框、滑块、图片上传、文件选择，三十多种组件随便组合。写完 demo.launch()，本地 localhost:7860 就能打开。再加个 share=True，几秒钟生成一个公网链接，别人直接在浏览器里试你的模型。

不需要注册账号，不需要租服务器，本地跑着就行。

2、为什么要用它

做 ML 的人都有过这种体验：模型训完了，效果还行，但要给别人演示的时候卡住了。

自己写前端？不会。用 Streamlit 凑合？交互不够灵活。部署到云端？光配环境就半天。更麻烦的是，每个人想试一下都得先配 Python 环境、装依赖、跑脚本，一轮演示下来光教人装环境就花了两小时。

Gradio 把这条路压缩到了几行代码：

import gradio as gr

def greet(name, intensity):
    return "Hello, " + name + "!" * int(intensity)

demo = gr.Interface(
    fn=greet,
    inputs=["text", "slider"],
    outputs=["text"],
)
demo.launch()

运行后浏览器自动弹出，左边输入文字和滑块，右边显示结果。整个过程不超过一分钟。

3、核心能力

Interface 是入口。传入函数、输入组件、输出组件，三件事搞定。适合快速原型，适合给客户演示。

Blocks 是进阶。要自定义布局、多数据流、组件联动，用 Blocks。Automatic1111 的 Stable Diffusion Web UI 就是用它写的。

ChatInterface 专门做聊天机器人。提供一个回复函数，界面自动生成，消息历史、清空按钮、流式输出全包。

热重载。开发时用 gradio app.py 替代 python app.py，改代码自动刷新页面。还有 --vibe 模式，在浏览器里用自然语言编辑应用。不用反复切编辑器和浏览器，调试效率直接翻倍。

分享。share=True 一行代码，生成临时公网链接。模型和计算都在本地跑，数据不外传。

4、生态

Gradio 不只是一个 Python 包，是一整套工具链：

• gradio_client：Python 客户端，程序化调用任意 Gradio 应用
• @gradio/client：JavaScript 客户端，前端项目也能直接调
• Hugging Face Spaces：免费托管 Gradio 应用的平台，社区里大量现成 demo
• Server Mode：只用 Gradio 后端搭前端，队列、流式、MCP、ZeroGPU 全内置

5、适合谁用

• 做机器学习、需要给模型快速搭演示界面的开发者和研究员
• 在搭 AI Agent、需要给 Agent 加交互界面的团队
• 做 RAG 系统、需要可视化验证工具的工程师

6、安装

Python 3.10 以上，一行命令：

pip install --upgrade gradio

建议装在虚拟环境里。详细教程看官方文档。

---

Gradio 从 2019 年发了第一篇论文，到现在七年，把"给模型做 demo"这件事的门槛降到了最低。42,892 个 Star，说明用过的人觉得确实好使。

Gradio 从 2019 年发了第一篇论文，到现在七年，把"给模型做 demo"这件事的门槛降到了最低。42,892 个 Star，说明用过的人觉得确实好使。