Skip to content

Jobs: document names and label updates (huggingface_hub v1.24.0)#2653

Merged
davanstrien merged 2 commits into
mainfrom
jobs-naming-labels
Jul 20, 2026
Merged

Jobs: document names and label updates (huggingface_hub v1.24.0)#2653
davanstrien merged 2 commits into
mainfrom
jobs-naming-labels

Conversation

@davanstrien

@davanstrien davanstrien commented Jul 17, 2026

Copy link
Copy Markdown
Member

huggingface_hub v1.24.0 added optional names for Jobs (release notes, huggingface/huggingface_hub#4532): a --name flag on hf jobs run / uv run / scheduled run, and a hf jobs labels command to update labels on an existing Job. Names are stored as the name label and shown in the Jobs UI.

This PR brings the hub-docs Jobs pages up to date:

  • jobs-configuration.md: adds a "Name a Job" subsection and an "Update labels" subsection (hf jobs labels with --label / --name / --clear semantics) to the existing Labels section; fixes a -label -> --label typo.
  • jobs-schedule.md: adds a named scheduled job example.

All examples were run against v1.24.0 before opening this PR.

🤖 Generated with Claude Code

https://claude.ai/code/session_01PLsT16XBYd5dTHhJvMxpVm


Note

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

Overview
Updates the Hub Jobs docs for huggingface_hub v1.24.0 CLI behavior around labels and optional job names.

In jobs-configuration.md, the Labels section now documents --name on hf jobs run (stored as the name label, UI grouping, non-unique), hf jobs labels for mutating labels on existing jobs (--label replaces all labels, --name alone preserves others, --clear removes all), and fixes a typo (-label--label).

jobs-schedule.md adds an example for hf jobs scheduled run --name on recurring jobs.

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

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

Comment thread docs/hub/jobs-configuration.md Outdated
Co-authored-by: Julien Chaumond <julien@huggingface.co>
@davanstrien
davanstrien merged commit 63e84c7 into main Jul 20, 2026
3 checks passed
@davanstrien
davanstrien deleted the jobs-naming-labels branch July 20, 2026 15:00
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