Skip to content

docs: add resource group cost attribution#2565

Merged
zaid-alhadad merged 2 commits into
mainfrom
docs/resource-group-cost-attribution
Jun 17, 2026
Merged

docs: add resource group cost attribution#2565
zaid-alhadad merged 2 commits into
mainfrom
docs/resource-group-cost-attribution

Conversation

@zaid-alhadad

@zaid-alhadad zaid-alhadad commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • docs/hub/jobs-pricing.md: new "Bill to a resource group" subsection — explains how to pass a resource group ID as namespace when creating a job
  • docs/inference-providers/pricing.md: note that X-HF-Bill-To also accepts a resource group ID (in addition to an org name)
  • docs/hub/security-resource-groups.md: new "Cost attribution" section covering all four compute services (Spaces, Jobs, Inference Providers, Inference Endpoints)

Ref: https://github.com/huggingface-internal/moon-landing/pull/18244 (merged) and https://github.com/huggingface-internal/moon-landing/pull/18333

Test plan

  • Verify links between the three pages resolve correctly
  • Confirm resource group ID lookup path (org settings > Resource Groups) is accurate

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only updates with no runtime or security code changes.

Overview
Documents how Enterprise customers can attribute compute spend to Resource Groups, with cross-links between Hub Jobs, Inference Providers, and the Resource Groups guide.

Jobs (jobs-pricing.md): new Bill to a resource group section—membership requirement, using the group ID as namespace (CLI and huggingface_hub.run_job).

Resource Groups (security-resource-groups.md): new Cost attribution section for Spaces (automatic), Jobs (namespace), Inference Providers (X-HF-Bill-To / bill_to), and Inference Endpoints (automatic from repo; catalog endpoints excluded).

Inference Providers (pricing.md): extends org billing to allow X-HF-Bill-To: <resource-group-id> when the token user is in that group.

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

Document that resource group IDs can be passed as namespace for Jobs
and as X-HF-Bill-To for Inference Providers to attribute costs to a
specific resource group. Add a Cost attribution section to the resource
groups guide covering all four compute services.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@HuggingFaceDocBuilderDev

HuggingFaceDocBuilderDev commented Jun 15, 2026

Copy link
Copy Markdown

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@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: 4cd1feaaaf

ℹ️ 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".

Comment thread docs/hub/security-resource-groups.md Outdated
Comment thread docs/inference-providers/pricing.md Outdated
Comment thread docs/hub/jobs-pricing.md Outdated
Comment thread docs/hub/security-resource-groups.md Outdated
Comment thread docs/hub/jobs-pricing.md Outdated
Comment thread docs/hub/security-resource-groups.md
Comment thread docs/inference-providers/pricing.md Outdated

@Pierrci Pierrci 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.

lgtm 👍

@zaid-alhadad
zaid-alhadad merged commit a77bf63 into main Jun 17, 2026
4 checks passed
@zaid-alhadad
zaid-alhadad deleted the docs/resource-group-cost-attribution branch June 17, 2026 11:25
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.

4 participants