Skip to content

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

Open
gary149 wants to merge 1 commit into
mainfrom
docs/spaces-paid-compute-gate
Open

Update Spaces docs: paid plan required for compute Spaces, ZeroGPU free tier#2624
gary149 wants to merge 1 commit into
mainfrom
docs/spaces-paid-compute-gate

Conversation

@gary149

@gary149 gary149 commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

What

Updates the Spaces documentation to match the new creation UX:

  • Static Spaces stay free for everyone.
  • Creating Gradio and Docker Spaces (anything that runs on compute, including CPU Basic) requires a paid plan: PRO for personal accounts, Team or Enterprise for organizations.
  • Free personal accounts in good standing (verified email, account older than 30 days) can host up to 2 ZeroGPU Spaces. PRO accounts up to 10, paid organizations up to 50.
  • Duplication follows the same rules as creation.

Files

  • spaces-overview.md: creation gate warning, hardware section wording, duplication note
  • spaces-gpus.md: note under the CPU hardware table
  • spaces-zerogpu.md: document the free tier in hosting section and hosting limitations
  • pro.md / billing.md: PRO benefits bullet aligned with the pricing page copy
  • spaces-sdks-static.md: static Spaces never require a paid plan

When to merge

Draft until the corresponding Hub-side change is deployed. The ZeroGPU free tier is already live; the compute creation gate is not yet.


Note

Low Risk
Documentation-only wording changes with no runtime or security impact; note the PR is intended to merge after the Hub creation gate ships.

Overview
Updates Hub docs to match the new Spaces creation rules: static Spaces stay free; Gradio and Docker (compute, including CPU Basic) require PRO (personal) or Team/Enterprise (orgs) to create or duplicate, with a ZeroGPU carve-out for eligible free personal accounts (up to 2 hosted Spaces; PRO up to 10, orgs up to 50).

Adds creation warnings in spaces-overview.md, a CPU Basic note in spaces-gpus.md, static-SDK clarification in spaces-sdks-static.md, and expanded ZeroGPU hosting limits in spaces-zerogpu.md. PRO / billing benefit bullets now mention compute Gradio/Docker creation plus the 10 ZeroGPU cap; billing copy no longer calls compute’s free tier “comprehensive.”

Reviewed by Cursor Bugbot for commit cbd8417. Bugbot is set up for automated code reviews on this repo. Configure here.

…ee tier

Static Spaces stay free for everyone. Creating Gradio/Docker Spaces
(compute) now requires PRO for personal accounts, Team or Enterprise
for organizations. Free personal accounts in good standing can host
up to 2 ZeroGPU Spaces (10 for PRO, 50 for paid orgs).

@julien-c julien-c left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

ok

@gary149 gary149 marked this pull request as ready for review July 6, 2026 10:24

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cbd84173f7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

**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).

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 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants