# Huggingface zerogpu

> Huggingface zerogpu is an open-source agent skill for ai models and llm tooling. AI demos and GPU compute with Gradio Spaces and Hugging Face Spaces ZeroGPU. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/huggingface/skills/tree/main/skills/huggingface-zerogpu
- **Repository:** https://github.com/huggingface/skills
- **GitHub stars:** 11,356
- **License:** Apache-2.0
- **Skill name:** huggingface-zerogpu
- **Collection:** https://github.com/huggingface/skills
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-17

## About

AI demos and GPU compute with Gradio Spaces and Hugging Face Spaces ZeroGPU. Use when writing or reviewing code that uses `@spaces.GPU`, configuring `python_version` or `requirements.txt` for a ZeroGPU Space, or handling ZeroGPU-specific code constraints — pickle-based process isolation, `gr.State` semantics across the worker boundary, no `torch.compile` (use AoTI instead), CUDA wheel-only builds (no `nvcc` at build or runtime), large vs xlarge sizing, and dynamic duration callables. Make sure to use this skill whenever the user mentions ZeroGPU, `@spaces.GPU`, or the `spaces` Python package, or hits ZeroGPU-specific code errors like `PicklingError` across the worker boundary, `illegal duration`, or `flash-attn` wheel-build failures — even when the user does not explicitly ask for ZeroGPU coding guidance. Trigger on `import spaces` or `@spaces.GPU` in code.

## When your agent uses it

> AI demos and GPU compute with Gradio Spaces and Hugging Face Spaces ZeroGPU. Use when writing or reviewing code that uses `@spaces.GPU`, configuring `python_version` or `requirements.txt` for a ZeroGPU Space, or handling ZeroGPU-specific code constraints — pickle-based process isolation, `gr.State` semantics across the worker boundary, no `torch.compile` (use AoTI instead), CUDA wheel-only builds (no `nvcc` at build or runtime), large vs xlarge sizing, and dynamic duration callables. Make sure to use this skill whenever the user mentions ZeroGPU, `@spaces.GPU`, or the `spaces` Python package, or hits ZeroGPU-specific code errors like `PicklingError` across the worker boundary, `illegal duration`, or `flash-attn` wheel-build failures — even when the user does not explicitly ask for ZeroGPU coding guidance. Trigger on `import spaces` or `@spaces.GPU` in code.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/huggingface/skills/tree/HEAD/skills/huggingface-zerogpu)
- [License: Apache-2.0](https://github.com/huggingface/skills/tree/HEAD/skills/huggingface-zerogpu)

## Install

### Claude Code

Copy the skill folder to `~/.claude/skills/huggingface-zerogpu` to use it in all your projects:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/huggingface-zerogpu &&
cp -R "$tmp/skills/huggingface-zerogpu" ~/.claude/skills/huggingface-zerogpu &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/huggingface-zerogpu` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/huggingface-zerogpu` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/huggingface-zerogpu &&
cp -R "$tmp/skills/huggingface-zerogpu" ~/.agents/skills/huggingface-zerogpu &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/huggingface-zerogpu` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/huggingface-zerogpu` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/huggingface-zerogpu &&
cp -R "$tmp/skills/huggingface-zerogpu" ~/.cursor/skills/huggingface-zerogpu &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/huggingface-zerogpu` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/huggingface/skills.git --path skills/huggingface-zerogpu
```

Or copy the folder to `~/.gemini/skills/huggingface-zerogpu` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/huggingface-zerogpu`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/huggingface-zerogpu &&
cp -R "$tmp/skills/huggingface-zerogpu" ~/.copilot/skills/huggingface-zerogpu &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/huggingface-zerogpu` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/huggingface/skills.git
```

Then copy `skills/skills/huggingface-zerogpu` into your agent's skills folder as `huggingface-zerogpu`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Huggingface zerogpu in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/huggingface-zerogpu to use it in all your projects, or to .claude/skills/huggingface-zerogpu in one project.

### Does Huggingface zerogpu run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Huggingface zerogpu?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Huggingface zerogpu?

The closest alternatives to Huggingface zerogpu are Academy guide, MCP builder, Claude API, Nano banana pro openrouter and Generate image.

## Alternatives

- [Academy guide](https://ai-powered.com/skills/academy-guide): Academy guide is an agent skill for ai models and llm tooling.
- [MCP builder](https://ai-powered.com/skills/mcp-builder): MCP builder is an agent skill for ai models and llm tooling.
- [Claude API](https://ai-powered.com/skills/claude-api): Claude API is an agent skill for ai models and llm tooling.
- [Nano banana pro openrouter](https://ai-powered.com/skills/nano-banana-pro-openrouter): Nano banana pro openrouter is an open-source agent skill for design and media.
- [Generate image](https://ai-powered.com/skills/generate-image): Generate image is an open-source agent skill for design and media.
- [Phoenix evals](https://ai-powered.com/skills/phoenix-evals): Phoenix evals is an open-source agent skill for ai models and llm tooling.
- [Tldr prompt](https://ai-powered.com/skills/tldr-prompt): Tldr prompt is an open-source agent skill for ai models and llm tooling.
- [Arize AI provider integration](https://ai-powered.com/skills/arize-ai-provider-integration): Arize AI provider integration is an open-source agent skill for ai models and llm tooling.

---
Source: https://ai-powered.com/skills/huggingface-zerogpu
