Gradio 速查表
Gradio 是快速构建 ML/AI 演示界面的 Python 库。一行代码即可运行 Web 界面，支持各种输入输出组件，一键分享公网链接或部署到 HuggingFace Spaces。内置命令行聊天界面（gradio cc）用于快速与 AI 模型对话。
更新: 2026-07-20·16 条命令
快速开始
``bash
# 安装
pip install gradio
# 运行应用（开发模式，热重载） gradio app.py
# 创建公网分享链接 gradio app.py --share
# 命令行 AI 聊天 gradio cc --model gpt-4o
# 部署到 HuggingFace Spaces
gradio deploy
`
应用开发
创建包含 Gradio 接口函数的 Python 文件。gradio CLI 以开发模式运行，自动热重载。支持文本、图片、音频、视频等多种输入输出组件。
分享
--share 通过 Gradio Share 隧道创建公网 URL（有效期 72 小时）。适合无需部署即可分享演示给客户或协作者。
HuggingFace Spaces
gradio deploy 处理完整部署流程：创建 Space 仓库、上传代码、配置环境、提供永久 URL。Spaces 支持 GPU 加速。
命令行聊天
gradio cc` 提供终端聊天界面。支持多种 AI 模型后端。适合快速测试，无需构建完整 UI。
启动模式(9)
| 命令 | 难度 | ||
|---|---|---|---|
gradio --help显示 Gradio CLI 帮助 | 基础 | gradio --help | |
gradio app.py运行 Gradio 应用（开发模式，热重载） | 基础 | gradio app.py | |
gradio app.py --port指定运行的端口 | 基础 | gradio app.py --port 7861 | |
gradio app.py --share创建公网分享链接（Gradio Share） | 基础 | gradio app.py --share | |
pip install gradio安装 Gradio | 基础 | pip install gradio | |
gradio cc命令行聊天界面（与 AI 模型对话） | 基础 | gradio cc --model gpt-4o | |
gradio cc --model在 CLI 聊天中指定模型 | 基础 | gradio cc --model claude-sonnet-4 | |
gradio demo创建参考 demo 模板 | 基础 | gradio demo | |
gradio app.py --analytics-enabled禁用使用分析 | 基础 | gradio app.py --analytics-enabled false |
ai-server(7)
| 命令 | 难度 | ||
|---|---|---|---|
gradio deploy部署到 HuggingFace Spaces | 中级 | gradio deploy | |
gradio deploy --title指定 Space 标题 | 中级 | gradio deploy --title 'My Demo App' | |
gradio deploy --app-file指定应用入口文件 | 中级 | gradio deploy --app-file demo.py | |
gradio space create创建 HuggingFace Space | 中级 | gradio space create my-demo | |
gradio space delete删除 HuggingFace Space | 中级 | gradio space delete my-demo | |
gradio app.py --root-path设置应用根路径（反向代理时使用） | 中级 | gradio app.py --root-path /my-app | |
gradio app.py --auth启用用户名密码认证 | 中级 | gradio app.py --auth admin:password123 |
常见问题
本速查表数据整理自各工具官方文档。最后更新: 2026-07-20。