hf spaces zero-gpu-quota reports ZeroGPU usage
Introduced 2026-10-01 · score 0.96
HOW TO USE IT
Before calling ZeroGPU Spaces, check the remaining quota and reset time with `hf spaces zero-gpu-quota`.
WHY THIS HELPS
When building or maintaining a script that calls ZeroGPU Spaces, check the remaining quota and reset time before making calls.
REQUIREMENTS AND LIMITATIONS
- Version: v2.1.0
- --format json: Print quota results as JSON.
- Prerequisite: A fine-grained token must have the “Billing > Read billing usage and payment method status” permission.
- Quota values are expressed in GPU-seconds.
- `resets_at` is `None` if ZeroGPU has not been used since the last reset.
- A fine-grained token requires the "Billing > Read billing usage and payment method status" permission.
- The CLI prints a credit-purchase hint when less than 10% of the quota is left; the linked documentation says PRO, Team, and Enterprise users can purchase credits to continue beyond the daily quota.
- Docs conflict: The v2.1.0 CLI documentation shows `hf spaces zero-gpu quota` and its `--format json` form, while the release note names `hf spaces zero-gpu-quota`. The documentation does not confirm the release-note command spelling.
FIRST-PARTY EVIDENCE
- https://github.com/huggingface/huggingface_hub/releases/tag/v2.1.0
- https://github.com/huggingface/huggingface_hub/pull/5040
- https://huggingface.co/docs/huggingface_hub/v2.1.0/guides/cli
- https://huggingface.co/docs/huggingface_hub/v2.1.0/en/guides/manage-spaces
Check the installed version and the source before using it. Entry JSON