开发与工程

Hugging Face ZeroGPU 开发指南

帮助你构建可靠的 Gradio ZeroGPU AI 演示与 GPU 工作负载。

56/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 11k
最近更新
18 天前
License
Apache-2.0
hugging-facezerogpugradio-spacesgpu-compute
+3cudapytorchpython

这个 Skill 能做什么,适合哪些场景?

这是 Hugging Face Skills 单仓库中的一个独立 Agent Skill,专门面向使用 Gradio SDK 和 ZeroGPU 硬件的 Spaces。它指导开发者使用 `@spaces.GPU`、配置 Python 与依赖、处理进程隔离、并发、配额、CUDA 构建限制和模型加载。内容覆盖大与 xlarge 规格、动态运行时长、`gr.State` 跨进程语义以及示例缓存。它不适用于 Docker、Static 或 Streamlit Spaces;仓库整体采用 Apache-2.0 许可证。

指导编写和审查包含 import spaces 或 @spaces.GPU 的 Python 代码;说明如何在模块级加载模型并注册 CUDA 设备;帮助设置 duration、动态时长和 size;解释 Pickle 进程边界、gr.State、并发请求和临时输出文件的处理;指导配置 python_version、requirements.txt、PyTorch 版本和预构建 CUDA wheels;提供 ZeroGPU 示例缓存的配置方式。

适合
  • 使用 Gradio 构建 Hugging Face ZeroGPU 推理演示的开发者,需要正确放置 `@spaces.GPU`。
  • 遇到 `PicklingError`、`illegal duration`、`quota exceeded` 或 CUDA wheel 构建失败的 Space 维护者。
  • 需要为可变输入估算 GPU 运行时长、降低配额预检失败率的应用作者。
  • 将模型部署到 ZeroGPU、并希望避免并发请求污染全局状态或覆盖输出文件的工程师。
  • 需要安装 `flash-attn` 等 CUDA 依赖、但构建环境没有 `nvcc` 的开发者。

如何安装这个 Skill?

使用前请注意
  • 这是低置信度静态评估,未执行代码、安装依赖或验证 ZeroGPU 行为。
  • ZeroGPU 配额、硬件、Python/运行时版本和外部文档会变化;使用前应核对当前官方文档。
  • 技能依赖 Hugging Face Spaces、模型下载及可能的外部 wheel/Hub 地址,需单独评估网络可达性、供应链和敏感数据边界。
  • 未提供中文支持或中国大陆网络可用性的证据。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • Python
  • Gradio SDK Spaces
  • spaces Python package
  • PyTorch
  • Transformers

从仓库的 skills/ 目录复制或 symlink skills/huggingface-zerogpu 到 Codex 标准的 .agents/skills 位置,例如 $REPO_ROOT/.agents/skills 或 $HOME/.agents/skills。README 也说明可通过 Hugging Face CLI 按技能名安装:hf skills add <skill-name>;将占位符替换为目标技能名。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/huggingface-zerogpu" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 请审查这段使用 `@spaces.GPU` 的 Gradio Space 代码,检查 duration、Pickle 返回值、并发安全和 CUDA 依赖。

在支持该技能的编码代理中提出具体请求,例如:“请审查这段使用 @spaces.GPU 的 Gradio Space 代码,检查 duration、Pickle 返回值、并发安全和 CUDA 依赖。”也可直接提供包含 import spaces 或 @spaces.GPU 的代码;该技能应在这些触发条件出现时启用。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖 ZeroGPU 特有的配额、进程隔离、并发和 CUDA 构建问题。
  • 给出可直接采用的 Python、README frontmatter 和依赖配置模式。
  • 明确区分 ZeroGPU 与专用 GPU、CPU、Docker 和 Static Spaces 的运行边界。
  • 提醒使用最小合理 duration、模块级模型加载和 CPU 化返回值等容易被忽视的约束。
局限
  • 范围仅限 Gradio SDK Spaces 的 ZeroGPU 场景,不是通用 Gradio 或通用 Hugging Face 部署指南。
  • 当前后端 GPU、支持的 Python 版本、层级上限等会变化,需要查阅最新 ZeroGPU 文档。
  • 详细的并发、配额、运行机制和 CUDA 依赖说明依赖仓库中列出的 reference 文件。
  • 源码没有提供测试套件或兼容平台矩阵,采用前应在目标 Space 中验证具体依赖。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Hugging Face ZeroGPU 开发指南 本页 56 · 谨慎使用 ★ 11k 18 天前 Apache-2.0
CuTile 自动调优指南 ✓ NVIDIA · 官方 52 · 谨慎使用 ★ 3.6k 12 天前 Apache-2.0
NeMo MBridge GPU 内存调优 ✓ NVIDIA · 官方 61 · 推荐 ★ 3.6k 12 天前 Apache-2.0
DALI 动态模式开发助手 ✓ NVIDIA · 官方 58 · 推荐 ★ 3.6k 12 天前 Apache-2.0
Holoscan Python Wheel 安装助手 ✓ NVIDIA · 官方 50 · 谨慎使用 ★ 3.6k 12 天前 Apache-2.0

相较于同仓库的 huggingface-gradio 技能,本技能专注 ZeroGPU 的硬件、配额、进程和 CUDA 约束,而不是一般 Gradio 组件与事件监听。相较于专用 GPU Spaces,它描述的是按请求调度、分片 GPU 和配额模型;Docker 与 Static Spaces 不在其适用范围内。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
56/ 100 五分制 2.8 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全17 / 25 · 3.4/5

技能明确说明进程隔离、pickle、CUDA 张量返回、并发状态和固定文件路径可能导致数据泄露或覆盖,并建议使用临时路径;未见凭据处理、最小权限、用户确认、回滚机制或完整数据流披露,且依赖直接 URL 和外部 Hub,故扣分。

2可靠稳定9 / 20 · 2.3/5

文档对 ZeroGPU 的装载、配额、并发、依赖和失败类型给出较一致的规则与诊断提示;但本次仅静态阅读,未见针对关键路径的技能专属测试或执行证据,异常输入和版本漂移覆盖有限,按静态上限保守扣分。

3适用触发11 / 15 · 3.7/5

frontmatter 明确了 ZeroGPU、@spaces.GPU、import spaces 及典型错误的触发条件,并限定为 Gradio SDK Spaces、排除 Docker 和 Static Spaces;未说明中文交互支持,也未证明在中国大陆网络环境下核心 Hugging Face 服务可达,且对非 Gradio 或复杂工作负载的边界仍有限,故扣分。

4规范维护9 / 15 · 3.0/5

技能具备 frontmatter、范围、分层参考文件、代码示例、反模式、限制说明和依赖提示;仓库提供 Apache-2.0、CI 校验和修订信息,但未见该技能独立的版本策略、变更日志、维护责任人或明确更新路径,且大量规则依赖会变化的外部文档,故扣分。

5有效结果6 / 15 · 2.0/5

内容覆盖 ZeroGPU 的核心实现问题,包括 duration、配额、进程边界、并发、CUDA 构建和缓存,并提供可直接改写的示例;但没有执行验证或代表性产出证据,且部分结论依赖当前平台行为,静态评估下只能确认核心指导可能有用,不能确认完整可用性,故扣分。

6证据核验4 / 10 · 2.0/5

文件包含具体规则、代码片段、错误示例、引用路径及仓库 CI 的生成文件校验;但 CI 未显示覆盖 ZeroGPU 行为的测试,外部文档和运行时机制未在本材料中交叉验证,也没有独立复现记录,故只能给有限分数。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 86cdeee824b7 评估证据[1][2][3][4][5][6][7][8][9]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

它能用于普通 Gradio 或专用 GPU Space 吗?
它面向 ZeroGPU,但 `spaces` 包在非 ZeroGPU 环境下是无操作模式,`@spaces.GPU` 会透明通过;通用 Gradio 开发仍应参考同仓库的 `huggingface-gradio` 技能。
为什么短任务也要显式设置 duration?
平台会按声明的时长进行配额预检和队列排序,而不是只看实际运行时间;默认 60 秒可能在用户剩余配额低于 60 秒时提前失败。
为什么不能直接返回 CUDA tensor?
装载返回值时会跨进程反序列化,可能触发被 ZeroGPU 阻止的 CUDA 初始化;应先转换为 CPU tensor 或 NumPy 数组。
它是否支持 flash-attn 的源码构建?
ZeroGPU 构建阶段没有 `nvcc`,因此应使用预构建 wheel;如果 PyPI 没有合适 wheel,需要从外部构建并固定 URL。

同仓库的其他 Skills

均来自 huggingface/skills

开发与工程

Hugging Face Spaces 构建器

帮助智能体创建、部署和维护 Hugging Face Spaces 应用。

★ 11k FS 50 谨慎使用 18 天前
开发与工程

LoRA Space Demo Builder

为 Hugging Face LoRA 自动设计并发布定制化 Gradio 演示 Space。

★ 11k FS 51 谨慎使用 18 天前
开发与工程

Hugging Face MCP 助手

通过 MCP 让智能体直接搜索、阅读并使用 Hugging Face Hub 资源。

★ 11k FS 36 不推荐 18 天前
数据与分析

Hugging Face LLM 训练器

在 Hugging Face 云端 GPU 上训练、微调并保存模型。

★ 11k FS 48 谨慎使用 18 天前
数据与分析

Hugging Face 本地模型评测

在本地硬件上为 Hugging Face Hub 模型运行可控的 inspect-ai 或 lighteval 评测。

★ 11k FS 47 谨慎使用 18 天前
开发与工程

Hugging Face Hub CLI 技能

让智能体通过 hf 命令管理 Hugging Face Hub 上的模型、数据集、空间、作业与基础设施。

★ 11k FS 42 不推荐 18 天前
数据与分析

Hugging Face 数据集探索助手

通过 Dataset Viewer API 探索、检索和提取 Hugging Face 数据集。

★ 11k FS 49 谨慎使用 18 天前
开发与工程

Hugging Face 论文研究助手

读取 AI 论文并提取 Hugging Face 论文页的结构化元数据。

★ 11k FS 49 谨慎使用 18 天前
数据与分析

Hugging Face 模型优选器

根据任务、基准成绩和设备内存筛选并推荐合适的 AI 模型。

★ 11k FS 42 不推荐 18 天前
开发与工程

Gradio 交互式应用构建技能

用 Python 快速构建 Gradio 网页界面、机器学习演示和聊天应用。

★ 11k FS 40 不推荐 18 天前
自动化与运维

SageMaker 执行角色预检

在 SageMaker 部署或训练前发现并验证可用的 IAM 执行角色。

★ 11k FS 41 不推荐 18 天前
数据与分析

Trackio 实验追踪

记录、监控并分析机器学习训练实验,让指标和诊断告警可供自动化工作流使用。

★ 11k FS 43 不推荐 18 天前
数据与分析

Sentence Transformers 训练助手

为检索、相似度与稀疏搜索训练 Sentence Transformers 模型。

★ 11k FS 47 谨慎使用 18 天前
数据与分析

Hugging Face 模型内存估算器

在不下载权重的情况下估算模型推理所需内存。

★ 11k FS 44 不推荐 18 天前
开发与工程

Hugging Face 本地模型运行器

帮助你从 Hugging Face 选择合适的 GGUF 量化模型,并用 llama.cpp 在本机运行。

★ 11k FS 44 不推荐 18 天前
数据与分析

Hugging Face 视觉模型训练助手

在 Hugging Face Jobs 云 GPU 上训练检测、分类与分割视觉模型,并将结果保存到 Hub。

★ 11k FS 43 不推荐 18 天前
开发与工程

Hugging Face API 工具构建器

把 Hugging Face API 调用组合成可复用、可管道化的命令行工具。

★ 11k FS 41 不推荐 18 天前
写作与内容

Hugging Face 论文发布器

在 Hugging Face Hub 上发布、关联和管理研究论文。

★ 11k FS 36 不推荐 18 天前
自动化与运维

SageMaker Python 环境管家

为 SageMaker 与 AWS 任务创建隔离且版本正确的 Python 环境。

★ 11k FS 49 谨慎使用 18 天前
自动化与运维

SageMaker 服务镜像选择器

为 Hugging Face 模型选择兼容的 SageMaker 服务容器,并获取当前区域的镜像 URI。

★ 11k FS 47 谨慎使用 18 天前

相关 Skills