Skip to content

Add pricing information for exposed ports in Jobs#2550

Merged
zaid-alhadad merged 2 commits into
mainfrom
jobs-exposed-port-pricing
Jun 12, 2026
Merged

Add pricing information for exposed ports in Jobs#2550
zaid-alhadad merged 2 commits into
mainfrom
jobs-exposed-port-pricing

Conversation

@zaid-alhadad

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

Copy link
Copy Markdown
Contributor

Note

Low Risk
Documentation-only update to jobs pricing; no code or billing logic changes.

Overview
Documents exposed ports billing for Hugging Face Jobs in the pricing guide.

Adds an Exposed ports subsection: port exposure is a flat $0.01/hour per Job on top of hardware, billed by the minute only while the Job is Starting or Running, with a link to Docker Jobs configuration for how ports are exposed.

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

@zaid-alhadad zaid-alhadad requested a review from lhoestq June 11, 2026 11:39
@HuggingFaceDocBuilderDev

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.

@Wauplin Wauplin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

👍

Comment thread docs/hub/jobs-pricing.md Outdated
Comment thread docs/hub/jobs-pricing.md Outdated

| **Product** | **Hourly Price** |
|----------------------- | ----------------- |
| Exposed port | $0.01 |

@julien-c julien-c Jun 11, 2026

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.

Suggested change
| Exposed port | $0.01 |
| Exposed port | $0.001 |

was supposed to be this i think?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

You said same price a basic CPU so $0.01/h ($0.000167/minute)

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.

Suggested change
| Exposed port | $0.01 |
| Exposed ports | $0.01 |

@julien-c julien-c Jun 12, 2026

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.

no pretty sure i said 1/10th of CPU-basic :)

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.

bt no strong opinion

Comment thread docs/hub/jobs-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 with the suggestions

Comment thread docs/hub/jobs-pricing.md Outdated

| **Product** | **Hourly Price** |
|----------------------- | ----------------- |
| Exposed port | $0.01 |

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.

Suggested change
| Exposed port | $0.01 |
| Exposed ports | $0.01 |

Wauplin added a commit that referenced this pull request Jun 12, 2026
* docs: add expose ports section to Jobs configuration guide

Document the new --expose / expose=[] option that lets users expose
container ports through the public jobs proxy (available since
huggingface_hub v1.19.0). Includes CLI and Python examples, URL
format, and authentication requirements.

Complements #2550 which covers pricing.

Co-authored-by: Lucain <Wauplin@users.noreply.github.com>

* nit

* bit

* revert

* nit

* docs: add Sandboxes section to Jobs examples page

Mention that expose ports makes Jobs a great fit for building
sandboxes (temporary self-contained environments for agents and
LLM applications).

Co-authored-by: Lucain <Wauplin@users.noreply.github.com>

* Update docs/hub/jobs-configuration.md

Co-authored-by: Daniel van Strien <davanstrien@users.noreply.github.com>

* Update docs/hub/jobs-configuration.md

Co-authored-by: Daniel van Strien <davanstrien@users.noreply.github.com>

* Update docs/hub/jobs-configuration.md

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Lucain <Wauplin@users.noreply.github.com>
Co-authored-by: Daniel van Strien <davanstrien@users.noreply.github.com>
@zaid-alhadad zaid-alhadad merged commit cfb9e47 into main Jun 12, 2026
3 checks passed
@zaid-alhadad zaid-alhadad deleted the jobs-exposed-port-pricing branch June 12, 2026 19:00
Pierrci added a commit that referenced this pull request Jun 12, 2026
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.

5 participants