Skip to content

Update Spaces docs: paid plan required for compute Spaces, ZeroGPU free tier #2624

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gary149 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update Spaces docs: paid plan required for compute Spaces, ZeroGPU free tier #2624

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/hub/billing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ The PRO subscription unlocks essential features for serious users, including:
- Higher bandwidth and API [rate limits](./rate-limits)
- Included credits for [Inference Providers](/docs/inference-providers/)
- Higher tier for ZeroGPU Spaces usage, and pay-as-you-go quota extension
- Ability to create ZeroGPU Spaces and use Dev Mode
- Ability to create Gradio and Docker Spaces running on compute, host up to 10 ZeroGPU Spaces, and use Dev Mode
- Ability to publish Social Posts and Community Blogs
- Leverage the [Data Studio](./data-studio) on private datasets

Expand All @@ -56,7 +56,7 @@ See the full pricing tiers at [huggingface.co/pricing](https://huggingface.co/pr

We also directly provide compute services with [Spaces](./spaces), [Inference Endpoints](https://huggingface.co/docs/inference-endpoints/index) and [Inference Providers](https://huggingface.co/docs/inference-providers/index).

While most of our compute services have a comprehensive free tier, users and organizations can pay to access more powerful hardware accelerators.
While several of our compute services have a free tier, users and organizations can pay to access more powerful hardware accelerators.

The billing for our compute services is usage-based, meaning you only pay for what you use. You can monitor your usage at any time from your billing dashboard, located in your user's or organization's settings menu.

Expand Down
2 changes: 1 addition & 1 deletion docs/hub/pro.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ The PRO subscription unlocks essential features for serious users, including:
- Higher bandwidth and API [rate limits](./rate-limits)
- Included credits for [Inference Providers](/docs/inference-providers/)
- Higher tier for [ZeroGPU Spaces](./spaces-zerogpu) usage, and pay-as-you-go quota extension
- Ability to create ZeroGPU Spaces and use [Dev Mode](./spaces-dev-mode)
- Ability to create Gradio and Docker Spaces running on compute, host up to 10 [ZeroGPU Spaces](./spaces-zerogpu), and use [Dev Mode](./spaces-dev-mode)
- Ability to publish Social Posts and Community Blogs
- Leverage the [Data Studio](./data-studio) on private datasets

Expand Down
3 changes: 3 additions & 0 deletions docs/hub/spaces-gpus.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,9 @@ In the following tables, you can see the Specs for the different upgrade options
| CPU Basic | 2 vCPU | 16 GB | - | 50 GB | Free! |
| CPU Upgrade | 8 vCPU | 32 GB | - | 50 GB | $0.03 |

> [!NOTE]
> CPU Basic has no hourly cost, but creating a new Space that runs on compute (Gradio or Docker) requires a paid plan. Static Spaces are free for everyone. See the [Spaces Overview](./spaces-overview#hardware-resources) for details.

### GPU

| **Hardware** | **CPU** | **Memory** | **GPU Memory** | **Disk** | **Hourly Price** |
Expand Down
7 changes: 5 additions & 2 deletions docs/hub/spaces-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ In the following sections, you'll learn the basics of creating a Space, configur

**To make a new Space**, visit the [Spaces main page](https://huggingface.co/spaces) and click on **Create new Space**. Along with choosing a name for your Space, selecting an optional license, and setting your Space's [visibility](#space-visibility) (public, protected, or private), you'll be prompted to choose the **SDK** for your Space. The Hub offers three SDK options: Gradio, Docker and static HTML. If you select "Gradio" as your SDK, you'll be navigated to a new repo showing the following page:

> [!WARNING]
> Static Spaces are free for everyone. Gradio and Docker Spaces run on compute and require a paid plan to create: <a href="https://huggingface.co/pro">PRO</a> for personal accounts, <a href="https://huggingface.co/enterprise">Team or Enterprise</a> for organizations. Free personal accounts in good standing can still host up to 2 Gradio Spaces running on [ZeroGPU](./spaces-zerogpu).

@chatgpt-codex-connector chatgpt-codex-connector Bot Jul 6, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Hold compute-gate docs until the Hub change ships

The commit message states that the compute creation gate is not deployed yet, but this warning presents it as current behavior. If these docs publish before the Hub-side change, free users will be told they need PRO/Team/Enterprise to create Gradio or Docker Spaces even though the product still allows it, which is misleading for a billing/creation flow. Please keep this wording out until the gate is live or mark it explicitly as upcoming.

Useful? React with 👍 / 👎.


<div class="flex justify-center">
<img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-blank-space.png"/>
<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-blank-space-dark.png"/>
Expand Down Expand Up @@ -43,7 +46,7 @@ You can set a Space's visibility from the **Settings** tab using the visibility

## Hardware resources

Each Spaces environment is limited to 16GB RAM, 2 CPU cores and 50GB of (not persistent) disk space by default, which you can use free of charge. You can upgrade to better hardware, including a variety of GPU accelerators, for a [competitive price](https://huggingface.co/pricing#spaces). To request an upgrade, please click the _Settings_ button in your Space and select your preferred hardware environment.
Each Spaces environment is limited to 16GB RAM, 2 CPU cores and 50GB of (not persistent) disk space by default. The default CPU Basic hardware has no hourly cost, but creating a Space that runs on compute (Gradio or Docker) requires a paid plan, while Static Spaces are free for everyone. You can upgrade to better hardware, including a variety of GPU accelerators, for a [competitive price](https://huggingface.co/pricing#spaces). To request an upgrade, please click the _Settings_ button in your Space and select your preferred hardware environment.

| **Hardware** | **CPU** | **Memory** | **GPU Memory** | **Hourly Price** |
|----------------------- |-------------- |------------- |---------------- | ----------------- |
Expand Down Expand Up @@ -117,7 +120,7 @@ If you want to duplicate a Space, you can click the three dots at the top right
* Storage: If the original repo uses a storage bucket, you will be prompted to configure storage. Read more about disk usage and storage [here](./spaces-storage).
* Secrets and variables: If the original repo has set some secrets and variables, you'll be able to set them while duplicating the repo.

Some Spaces might have environment variables that you may need to set up. In these cases, the duplicate workflow will auto-populate the public Variables from the source Space, and give you a warning about setting up the Secrets. The duplicated Space will use a free CPU hardware by default, but you can later upgrade if needed.
Some Spaces might have environment variables that you may need to set up. In these cases, the duplicate workflow will auto-populate the public Variables from the source Space, and give you a warning about setting up the Secrets. The duplicated Space will use CPU Basic hardware by default, but you can later upgrade if needed. Duplicating follows the same rules as creating a new Space: duplicating a Gradio or Docker Space requires a paid plan for the target account or organization (with the same [ZeroGPU free tier](./spaces-zerogpu) exception for personal accounts).

## Networking

Expand Down
2 changes: 2 additions & 0 deletions docs/hub/spaces-sdks-static.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

Spaces also accommodate custom HTML for your app instead of using Streamlit or Gradio. Set `sdk: static` inside the `YAML` block at the top of your Spaces **README.md** file. Then you can place your HTML code within an **index.html** file.

Static Spaces are free for everyone: they are served directly without running on compute, so unlike [Gradio](./spaces-sdks-gradio) and [Docker](./spaces-sdks-docker) Spaces, creating them never requires a paid plan.

Here are some examples of Spaces using custom HTML:

* [Smarter NPC](https://huggingface.co/spaces/mishig/smarter_npc): Display a PlayCanvas project with an iframe in Spaces.
Expand Down
4 changes: 3 additions & 1 deletion docs/hub/spaces-zerogpu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@ Unlike traditional single-GPU allocations, ZeroGPU's efficient system lowers bar
- ZeroGPU Spaces are available to use for free to all users. (Visit [the curated list](https://huggingface.co/spaces/enzostvs/zero-gpu-spaces)).
- [PRO users](https://huggingface.co/subscribe/pro) get x8 more daily usage quota, highest priority in GPU queues, and can go beyond their daily quota using pre-paid credits when using any ZeroGPU Spaces.
- **Hosting your own ZeroGPU Spaces**
- Personal accounts: [Subscribe to PRO](https://huggingface.co/settings/billing/subscription) to access ZeroGPU in the hardware options when creating a new Gradio SDK Space.
- Free personal accounts: accounts in good standing (verified email, account older than 30 days) can host up to 2 ZeroGPU Spaces for free.
- PRO accounts: [Subscribe to PRO](https://huggingface.co/settings/billing/subscription) to host up to 10 ZeroGPU Spaces under your account.
- Organizations: [Subscribe to a Team or Enterprise plan](https://huggingface.co/enterprise) to enable ZeroGPU Spaces for all organization members.

## Technical Specifications
Expand Down Expand Up @@ -175,6 +176,7 @@ You can add credits from your [billing settings](https://huggingface.co/settings

## Hosting Limitations

- **Free personal accounts**: Maximum of 2 ZeroGPU Spaces, for accounts in good standing (verified email, account older than 30 days).
- **Personal accounts ([PRO subscribers](https://huggingface.co/subscribe/pro))**: Maximum of 10 ZeroGPU Spaces.
- **Organization accounts ([Team & Enterprise](https://huggingface.co/enterprise))**: Maximum of 50 ZeroGPU Spaces.

Expand Down
Loading