releases.shpreview

Jobs get optional names; README recast for CLI-first

v1.24.0

1 feature1 enhancement1 fixThis release1 featureNew capabilities1 enhancementImprovements to existing features1 fixBug fixesAI-tallied from the release notes
From the original release noteView original ↗

📊 Name your Jobs!

Jobs on the Hub now support an optional --name flag on the CLI and a name parameter on the Python API (run_job, run_uv_job, create_scheduled_job, create_scheduled_uv_job). Names are stored as the name label and make Jobs easier to find and identify in the UI. You can also name an existing Job using hf jobs labels <job_id> --name my-job. Names are optional and do not need to be unique.

# Create a named Job
hf jobs run --name training-v2 python:3.12 python train.py

# Name an existing Job
hf jobs labels <job_id> --name training-v2

# Named scheduled Job
hf jobs scheduled run @hourly --name hourly-task python:3.12 python -c 'print("This runs every hour!")'

📚 Documentation: CLI guide, Jobs guide

  • [Jobs] Add optional names to Jobs CLI and API by @Wauplin in #4532

📖 Documentation

  • [Docs] Fix HTTP client name in download docs by @cupkk in #4523

The README has been completely refreshed to put the hf CLI first. The standalone installer (curl/PowerShell) and a terminal quick start — covering auth login, models ls, download, upload, and jobs run — now appear before the Python library section. A new For AI agents section introduces hf skills add for Codex, Cursor, OpenCode, Claude Code, and other AI tools. The Python content remains intact under the renamed Use the Python library heading, with refreshed example models and a corrected tagline ("The official CLI and Python client for the Hugging Face Hub").

🐛 Bug and typo fixes

  • [Download] Fix xet download rate: show summed, not per-file speed by @rajatarya in #4530

🏗️ Internal

Fetched July 17, 2026