Dev & Engineering

Hugging Face ZeroGPU Builder

Build dependable Gradio AI demos and GPU workloads on Hugging Face ZeroGPU.

56/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 11k
Last updated
18d ago
License
Apache-2.0
hugging-facezerogpugradio-spacesgpu-compute
+3cudapytorchpython

What does this skill do, and when should you use it?

This is one focused Agent Skill in the Hugging Face Skills monorepo, designed for Gradio SDK Spaces using ZeroGPU hardware. It guides developers through `@spaces.GPU`, Python and dependency configuration, process isolation, concurrency, quota behavior, CUDA build constraints, and model loading. It also covers large versus xlarge sizing, dynamic duration callables, `gr.State` semantics across workers, and example caching. It does not target Docker, Static, or Streamlit Spaces; the overall repository is licensed under Apache-2.0.

Guides the authoring and review of Python code containing import spaces or @spaces.GPU; explains module-scope model loading and CUDA device registration; helps configure duration, dynamic duration estimates, and size; documents Pickle boundaries, gr.State, concurrent requests, and unique output paths; explains python_version, requirements.txt, PyTorch version matching, and prebuilt CUDA wheels; and shows how to reproduce ZeroGPU example-caching behavior locally.

Good fit
  • A developer building a Gradio inference demo on Hugging Face ZeroGPU who needs the correct `@spaces.GPU` structure.
  • A Space maintainer debugging `PicklingError`, `illegal duration`, `quota exceeded`, or CUDA wheel build failures.
  • An application author estimating runtime from variable inputs to reduce quota pre-check failures.
  • An engineer deploying models to ZeroGPU who needs to prevent shared-state corruption and output-file collisions under concurrency.
  • A developer installing CUDA-dependent packages such as `flash-attn` when the build environment lacks `nvcc`.

How do you install this skill?

Before you use it
  • This is a low-confidence static assessment; no code, dependency installation, or ZeroGPU behavior was executed or verified.
  • ZeroGPU quotas, hardware, Python/runtime versions, and external documentation may change; verify current official documentation before use.
  • The skill depends on Hugging Face Spaces, model downloads, and potentially external wheel or Hub URLs, requiring separate review of reachability, supply-chain risk, and sensitive-data boundaries.
  • No evidence was provided for Chinese-language support or mainland-China network availability.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Python
  • Gradio SDK Spaces
  • spaces Python package
  • PyTorch
  • Transformers

Copy or symlink skills/huggingface-zerogpu from the repository into a standard Codex .agents/skills location, such as $REPO_ROOT/.agents/skills or $HOME/.agents/skills. The README also documents installation through the Hugging Face CLI with hf skills add <skill-name>; replace the placeholder with the target skill name.

Generic route: install into Claude Code manually (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"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Review this `@spaces.GPU` Gradio Space for duration settings, Pickle-safe returns, concurrency safety, and CUDA dependencies.

In a coding agent that supports the skill, ask for a concrete task such as: “Review this @spaces.GPU Gradio Space for duration settings, Pickle-safe returns, concurrency safety, and CUDA dependencies.” You can also provide code containing import spaces or @spaces.GPU; those are explicit activation signals in the skill description.

What are this skill's strengths and limitations?

Pros
  • Addresses ZeroGPU-specific quota, process-isolation, concurrency, and CUDA build problems.
  • Provides actionable Python, README frontmatter, and dependency-configuration patterns.
  • Clearly distinguishes ZeroGPU from dedicated GPU, CPU, Docker, and Static Space environments.
  • Calls out easily missed constraints such as minimum realistic duration, eager model loading, and CPU-safe return values.
Limitations
  • Its scope is limited to Gradio SDK Spaces using ZeroGPU, rather than general Gradio or general Hugging Face deployment.
  • The backing GPU, supported Python versions, and tier limits can change, so current ZeroGPU documentation remains necessary.
  • Detailed concurrency, quota, lifecycle, and CUDA dependency guidance relies on the repository’s referenced files.
  • The supplied source does not provide a test suite or platform compatibility matrix, so target-Space validation is still needed.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Hugging Face ZeroGPU Builder this page 56 · Use with care ★ 11k 18d ago Apache-2.0
CuTile Autotuning Guide ✓ NVIDIA · Official 52 · Use with care ★ 3.6k 12d ago Apache-2.0
NeMo MBridge GPU Memory Tuning ✓ NVIDIA · Official 61 · Recommended ★ 3.6k 12d ago Apache-2.0
DALI Dynamic Mode Assistant ✓ NVIDIA · Official 58 · Recommended ★ 3.6k 12d ago Apache-2.0
Holoscan Python Wheel Installer ✓ NVIDIA · Official 50 · Use with care ★ 3.6k 12d ago Apache-2.0

Compared with the repository’s huggingface-gradio skill, this skill focuses on ZeroGPU hardware, quota, process, and CUDA constraints rather than general Gradio components and event listeners. Compared with dedicated-GPU Spaces, it describes request scheduling, GPU slicing, and quota behavior; Docker and Static Spaces are outside its scope.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
56/ 100 5-point scale 2.8 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust17 / 25 · 3.4/5

The skill explicitly addresses process isolation, pickle boundaries, CUDA-tensor returns, concurrent state, and fixed-path data leakage or overwrites, with a tempfile mitigation. It does not provide credential handling, least-privilege controls, user confirmation, rollback, or complete data-flow disclosure; it also relies on direct URLs and external Hub services, so points are deducted.

2Reliability9 / 20 · 2.3/5

The guidance on loading, quotas, concurrency, dependencies, and failure types is fairly consistent and diagnostically useful. However, this is a static-only review with no skill-specific execution tests or reproduction evidence, limited abnormal-input coverage, and exposure to runtime-version drift; the score is conservatively capped below the static threshold.

3Adaptability11 / 15 · 3.7/5

The frontmatter gives precise triggers such as ZeroGPU, @spaces.GPU, import spaces, and named errors, and limits applicability to Gradio SDK Spaces while excluding Docker and Static Spaces. Chinese-language support is not evidenced, mainland-China reachability of core Hugging Face services is not established, and boundaries for non-Gradio or complex workloads remain incomplete, so points are deducted.

4Convention9 / 15 · 3.0/5

The skill has frontmatter, scope, progressive reference files, examples, anti-patterns, limitation disclosures, and dependency guidance. Repository context supplies Apache-2.0 licensing, CI validation, and a pinned revision, but there is no skill-specific version policy, changelog, named maintenance owner, or explicit update path, and many rules depend on changing external documentation.

5Effectiveness6 / 15 · 2.0/5

It covers the main ZeroGPU implementation concerns—duration, quota, process boundaries, concurrency, CUDA builds, and caching—and includes directly usable patterns. Static review provides no execution or representative-output evidence, and some claims depend on current platform behavior, so only limited core-task usefulness can be credited under the static cap.

6Verifiability4 / 10 · 2.0/5

The files provide concrete rules, code snippets, error examples, reference paths, and repository CI checks for generated artifacts. The supplied CI does not demonstrate tests of ZeroGPU behavior, runtime mechanisms are not independently corroborated in the material, and no reproduction record is included, so evidence remains limited.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 86cdeee824b7 Review evidence[1][2][3][4][5][6][7][8][9]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Can it be used with ordinary Gradio or dedicated GPU Spaces?
It targets ZeroGPU, but the `spaces` package is a no-op outside ZeroGPU and `@spaces.GPU` becomes a transparent passthrough. General Gradio work should use the repository’s `huggingface-gradio` skill.
Why set an explicit duration for a short task?
The platform pre-checks the declared duration against remaining quota and uses it for queue ranking, rather than relying only on actual runtime. The 60-second default can therefore reject a short task when less than 60 seconds remain.
Why should CUDA tensors not be returned directly?
Return values are unpickled across a process boundary, which can trigger CUDA initialization that ZeroGPU blocks. Convert them to CPU tensors or NumPy arrays first.
Does it support building flash-attn from source?
The ZeroGPU build phase has no `nvcc`, so dependencies should come from prebuilt wheels. If no suitable PyPI wheel exists, build one externally and pin its URL.

More skills from this repository

All from huggingface/skills

Dev & Engineering

Hugging Face Spaces Builder

Build, deploy, debug, and maintain machine-learning apps on Hugging Face Spaces.

★ 11k FS 50 Use with care 18d ago
Dev & Engineering

LoRA Space Demo Builder

Build and publish a tailored Gradio Space for a Hugging Face LoRA.

★ 11k FS 51 Use with care 18d ago
Dev & Engineering

Hugging Face MCP Assistant

Connect agents to Hugging Face Hub for searchable models, datasets, documentation, apps, and compute jobs.

★ 11k FS 36 Not recommended 18d ago
Data & Analysis

Hugging Face LLM Trainer

Train, fine-tune, and preserve models on Hugging Face cloud GPUs.

★ 11k FS 48 Use with care 18d ago
Data & Analysis

Hugging Face Local Evaluator

Run controlled inspect-ai or lighteval evaluations for Hugging Face Hub models on local hardware.

★ 11k FS 47 Use with care 18d ago
Dev & Engineering

Hugging Face Hub CLI Skill

Give agents command-line control over Hugging Face Hub models, datasets, Spaces, jobs, and infrastructure.

★ 11k FS 42 Not recommended 18d ago
Data & Analysis

Hugging Face Dataset Explorer

Explore, query, and extract Hugging Face datasets through the Dataset Viewer API.

★ 11k FS 49 Use with care 18d ago
Dev & Engineering

Hugging Face Paper Research Assistant

Read AI papers and retrieve structured metadata from Hugging Face paper pages.

★ 11k FS 49 Use with care 18d ago
Data & Analysis

Hugging Face Model Finder

Recommends AI models by task, benchmark performance, and available device memory.

★ 11k FS 42 Not recommended 18d ago
Dev & Engineering

Gradio Interactive App Builder

Build Gradio web interfaces, machine-learning demos, and chat apps in Python.

★ 11k FS 40 Not recommended 18d ago
Automation & Ops

SageMaker IAM Preflight

Find and validate a usable SageMaker execution role before deployment or training.

★ 11k FS 41 Not recommended 18d ago
Data & Analysis

Trackio Experiment Tracking

Log, monitor, and query machine-learning experiments with dashboards, diagnostic alerts, and automation-ready output.

★ 11k FS 43 Not recommended 18d ago
Data & Analysis

Sentence Transformers Training Assistant

Train retrieval, similarity, reranking, and sparse-search models with Sentence Transformers.

★ 11k FS 47 Use with care 18d ago
Data & Analysis

Hugging Face Model Memory Estimator

Estimate inference memory without downloading model weights.

★ 11k FS 44 Not recommended 18d ago
Dev & Engineering

Hugging Face Local Model Runner

Choose compatible GGUF quantizations from Hugging Face and run them locally with llama.cpp.

★ 11k FS 44 Not recommended 18d ago
Data & Analysis

Hugging Face Vision Trainer

Train detection, classification, and segmentation models on Hugging Face Jobs GPUs and persist the results to the Hub.

★ 11k FS 43 Not recommended 18d ago
Dev & Engineering

Hugging Face API Tool Builder

Turn Hugging Face API calls into reusable, composable command-line tools.

★ 11k FS 41 Not recommended 18d ago
Writing & Content

Hugging Face Paper Publisher

Publish, connect, and manage research papers on the Hugging Face Hub.

★ 11k FS 36 Not recommended 18d ago
Automation & Ops

SageMaker Python Environment Setup

Build an isolated, version-aligned Python environment for SageMaker and AWS automation.

★ 11k FS 49 Use with care 18d ago
Automation & Ops

SageMaker Serving Image Selector

Choose a compatible SageMaker serving container and retrieve the current regional image URI for a Hugging Face model.

★ 11k FS 47 Use with care 18d ago

Related skills