一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | huggingface-gradio(合集仓库子目录名) | 目录名 |
| 所属合集仓库 | huggingface/skills(Hugging Face 官方维护的 Agent Skills 仓库,覆盖数据集、模型训练、评测、Spaces 部署等 20 余个子技能) | GitHub API |
| 作者/维护者 | Hugging Face 官方;本子技能主要作者 Abubakar Abid(Gradio 联合创始人,现于 Hugging Face 负责 Gradio)、Freddy Boulton(Gradio 核心维护者) | GitHub API + 作者账号资料 |
| 来源链接 | https://github.com/huggingface/skills/tree/main/skills/huggingface-gradio | — |
| 许可证 | Apache License 2.0(仓库根 LICENSE 文件,子目录未单独声明) | GitHub API |
| 所属合集仓库整体 Stars/Forks | 10,882 / 720(注:该数字属整个合集仓库,覆盖 20 余个子技能,不代表本技能自身热度) | GitHub API |
| 该技能自身活跃度 | 目录下 3 次实质性提交,最近一次 2026-03-24(补充 CLI 命令文档);首次加入于 2026-02-24 | GitHub Commits API(路径限定查询) |
| 最新版本 | 无独立版本号(随仓库整体迭代,未使用 GitHub Releases) | GitHub API |
| 安装方式 | 见第十章 | 仓库根 README + Gradio 官方文档 |
二、功能介绍与亮点
huggingface-gradio 把 Gradio(一个用 Python 快速搭建 Web UI 与 ML 演示的库)的核心 API 与常见模式,整理成一份可直接注入 Agent 上下文的结构化参考——Agent 写 Gradio 应用时不再需要凭记忆猜组件参数,而是直接查这份权威速查表。
核心能力:
- 完整组件签名速查:Textbox、Slider、Dropdown、Chatbot 等全部内置组件的构造参数与事件列表逐一列出,避免 Agent 编造不存在的参数或事件名
- Interface / Blocks / ChatInterface 三种核心模式对照:从最简单的函数包装到自由布局的低层 API,各配最小可运行示例
- 覆盖进阶主题:流式输入输出、自定义 CSS/JS、应用分享部署,均有独立指南链接
- 配套完整示例集:另附一份 14KB 的
examples.md,收录多个端到端可运行的完整 Gradio 应用(文本/图像翻转、Tab 布局、折叠面板等) - 内置 CLI 集成说明:文档还覆盖
gradio info/gradio predict命令——可让 Agent 直接探测并调用任意公开 Gradio Space 的接口,无需额外写代码
亮点:该技能由 Gradio 联合创始人本人及核心维护者共同编写,Gradio 官方文档站(gradio.app)也专门收录了一篇《Gradio Skills for AI Coding Assistants》指南,并且 gradio 官方 Python 包本身内置了 gradio skills add 命令——说明这条 Agent 集成路径已被工具作者自己纳入产品能力,而不只是社区自发整理。
三、适用场景
所属分类:前端与设计
面向用 Python 快速搭建交互式网页界面的开发者——尤其是 ML/数据科学背景、不熟悉传统前端框架、但需要给模型或脚本套一个可分享网页界面(Demo、内部工具、原型验证)的用户。也适合已经在用 Gradio、但希望 Agent 写代码时减少参数记错、事件绑定写漏等低级错误的场景。
四、跨 Agent 兼容性
- Claude Code:✅ 原生支持——官方 README 提供插件市场安装路径(
/plugin marketplace add huggingface/skills),配合hf skills add按需安装本技能;Gradio 官方包也内置gradio skills add --claude命令可直接生成/安装该技能 - Codex:✅ 原生支持——官方文档说明可将技能目录复制或软链接到 Codex 标准的
.agents/skills位置,由 Codex 按 Agent Skills 标准自动发现 - OpenClaw:❓ 未验证——抓取到的官方材料未提及
- Hermes Agent:❓ 未验证——抓取到的官方材料未提及
(背景信息:huggingface/skills 同时以 Gemini CLI 扩展、Cursor 插件形式分发,但这两个客户端不在本报告固定评估的四个生态之内。)
五、推荐理由
由 Gradio 联合创始人亲自编写、Gradio 官方文档与官方包又反向收录了同一条集成路径,权威性在同类“框架速查表”技能里少见;内容是纯静态参考,没有代码执行与外发风险,装上即可让 Agent 少犯组件参数记错、事件绑错的低级错误。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 作为合集仓库子技能不套用整体星数;改看两条独立证据:其一,Gradio 本身(gradio-app/gradio)是 43,252 星的一线 ML Web 框架,持续每日活跃;其二,本技能被 Gradio 官方文档站单独收录一篇指南、且 gradio 官方包内置了同名安装命令,属工具作者自己认领的集成路径,而非纯社区整理 |
| 可用性 | 8 | SKILL.md 逾 24KB 加 14KB 示例集,组件签名与模式覆盖完整;安装路径清晰(插件市场 + hf skills add,或 Gradio 包原生命令);无付费依赖;但该子目录自身最近一次实质更新在 2026-03-24,距今约 4 个月,落在“近 6 个月”档而非“近 3 个月”档 |
| 安全性 | 9 | 纯参考文档类技能,不含可执行脚本,正文与示例集通读均为组件 API 与应用代码示例,未见可疑指令;gradio predict 的 --token 仅用于访问用户自己的私有 Space,属可选功能而非强制索取;Apache-2.0 开源可审计,作者为可查实的 Gradio 官方团队成员 |
综合评分:8.3
安全检查清单逐项结果:
① Shell 命令:无独立 shell 命令,涉及的 gradio CLI(info/predict)用途明确、范围限定在查询/调用指定 Space
② 联网外发:gradio predict/gradio info 会与目标 Gradio Space 通信,属该功能本身的必要行为,且目标由用户指定
③ API Key/凭据:仅在访问私有 Space 时需要 --token,为用户主动提供的可选参数,非强制索取
④ 可疑指令:通读 SKILL.md 及 examples.md,全部为组件参数、事件与示例代码,未发现提示词注入或越权操作迹象
⑤ 作者信誉:Hugging Face 官方仓库,主要作者为 Gradio 联合创始人与核心维护者,信誉可查实且良好
⑥ License:Apache License 2.0,明确
⑦ 最近维护:该子目录最近一次提交为 2026-03-24,约 4 个月前,仓库整体仍每日活跃(最近一次 push 为 2026-07-30)
七、跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| developing-with-streamlit(streamlit/agent-skills) | 运行时探测项目实际安装的 Streamlit 版本,动态加载对应版本官方文档 | 版本自适应是其核心卖点,避免“新语法教旧版本”的问题;本技能是静态整理的参考文档(metadata 标注版本为 4.x),二者面向不同的 Python Web UI 框架,技术选型上互斥而非直接竞争 |
| shadcn(shadcn-ui/ui) | React/TypeScript 生态的组件库集成技能,走官方 CLI 强制拉取组件源码 | 面向前端工程师主导的 React 项目,需要 Node.js 工具链;本技能面向 Python/ML 背景的开发者,无需任何前端构建工具即可产出可分享网页 |
| 不借助技能、直接查 Gradio 官方文档 | 人工翻阅 gradio.app 文档站 | Agent 需要在多个 Guide 页面间跳转拼凑组件签名,容易漏参数或用错事件名;本技能把高频用到的组件签名与模式整理进单一上下文,减少查阅与试错次数 |
八、用户评价
该子技能目前在第三方平台尚无具名用户评价。Gradio 官方文档站(gradio.app)已将“为 AI 编程助手安装 Gradio 技能”作为独立指南收录,是目前可查实的最直接的官方采纳证据。
九、其他补充
huggingface/skills 遵循开放的 Agent Skills 标准(agentskills.io),因此该技能同时以 Gemini CLI 扩展、Cursor 插件等形式分发。同仓库下的 huggingface-zerogpu 技能专门覆盖“用 Gradio + Hugging Face Spaces ZeroGPU 部署免费 GPU 算力 Demo”的进阶场景,可与本技能配合使用:先用本技能写好 Gradio 界面,再用 ZeroGPU 技能处理云端算力与部署细节。
十、安装使用方式
Claude Code:
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface/skills
hf skills add huggingface-gradio --claude --global
或直接使用 Gradio 官方包原生命令:
pip install -U gradio
gradio skills add --claude --global
Codex:
将仓库 skills/huggingface-gradio 目录复制或软链接到 Codex 标准位置(如 $REPO_ROOT/.agents/skills 或 $HOME/.agents/skills),Codex 会按 Agent Skills 标准自动发现并加载。
安装后注意事项:
无需重启 Agent,安装后即可在对话中直接触发(提及“用 Gradio 写一个界面”等指令);若要用到 gradio predict/gradio info 探测已部署的 Space,需本机已安装 gradio 包(pip install gradio)。
十一、注意事项
- 技能内容为特定时间点的 Gradio API 快照(metadata 标注版本 4.x),Gradio 版本升级后个别组件参数可能有增补或变更,建议关键项目对照官方文档站二次确认
- 该子目录最近一次实质更新距今约 4 个月,更新频率低于同仓库部分近期活跃的子技能(如 huggingface-trackio、huggingface-spaces)
- 作为合集仓库中的子技能,随 huggingface/skills 整体仓库迭代,无独立版本号,未来目录结构可能调整
- OpenClaw、Hermes Agent 的兼容性未在可抓取的官方材料中找到明确说明,建议实际使用前自行验证