huggingface_hub Files

Scheduled Jobs

In v0.34.0 release, we announced Jobs, a new way to run compute on the Hugging Face Hub. In this new release, we are announcing Scheduled Jobs to run Jobs on a regular basic. Think "cron jobs running on GPU".

This comes with a fully-fledge CLI:

hf jobs scheduled run @hourly ubuntu echo hello world
hf jobs scheduled run "0 * * * *" ubuntu echo hello world
hf jobs scheduled ps -a
hf jobs scheduled inspect <id>
hf jobs scheduled delete <id>
hf jobs scheduled suspend <id>
hf jobs scheduled resume <id>
hf jobs scheduled uv run @weekly train.py

• [Jobs] Add scheduled jobs api by @lhoestq in [#3306]

It is now possible to run a command with uv run:

hf jobs uv run --with lighteval -s HF_TOKEN lighteval endpoint inference-providers "model_name=openai/gpt-oss-20b,provider=groq" "lighteval|gsm8k|0|0"

• [Jobs] Support commands in hf jobs uv run by @lhoestq in [#3303]

Some other improvements have been added to the existing Jobs API for a better UX.

• [Jobs] Use current or stored token in a Job secrets by @lhoestq in [#3272]
• update uv image by @lhoestq in [#3270]

And finally, Jobs documentation has been updated with new examples (and some fixes):

• Fix bash history expansion in hf jobs example by @nyuuzyou in [#3277]
• Add timeout info to Jobs guide docs by @davanstrien in [#3281]
• Update jobs.md by @tre3x in [#3297]
• docs: Add link to uv-scripts organization in Jobs guide by @davanstrien in [#3326]
• docs: Add Docker images section for UV scripts in Jobs guide by @davanstrien in [#3327]
• docs: add link to TRL jobs training documentation by @davanstrien in [#3330]

CLI updates

In addition to the Scheduled Jobs, some improvements have been added to the hf CLI.

• [CLI] print help if no command provided by @Wauplin in [#3262]
• update hf auth whoami output by @hanouticelina in [#3274]
• Add 'user:' prefix to whoami command output for consistency by @gary149 in [#3267]
• Whoami: custom message only on unauthorized by @Wauplin in [#3288]

Inference Providers

Welcome Scaleway and PublicAI!

Two new partners have been integrated to Inference Providers: Scaleway and PublicAI! (as part of releases 0.34.5 and 0.34.6).

• feat: add scaleway inference provider by @Gnoale in [#3356]
• Add PublicAI provider by @Wauplin in [#3367]

Image-to-video

Image to video is now supported in the InferenceClient:

:::py
from huggingface_hub import InferenceClient

client = InferenceClient(provider="fal-ai")

video = client.image_to_video(
    "cat.png",
    prompt="The cat starts to dance",
    model="Wan-AI/Wan2.2-I2V-A14B",
)

• [Inference] Support image to video task by @hanouticelina in [#3289]

Miscellaneous

Header content-type is now correctly set when sending an image or audio request (e.g. for image-to-image task). It is inferred either from the filename or the URL provided by the user. If user is directly passing raw bytes, the content-type header has to be set manually.

• [InferenceClient] Add content-type header whenever possible + refacto by @Wauplin in [#3321]

A .reasoning field has been added to the Chat Completion output. This is used by some providers to return reasoning tokens separated from the .content stream of tokens.

• Add reasoning field in chat completion output by @Wauplin in [#3338]

MCP & tiny-agents updates

tiny-agents now handles AGENTS.md instruction file (see https://agents.md/).

• allow use of AGENTS.md as well as PROMPT.md by @evalstate in [#3317]

Tools filtering has already been improved to avoid loading non-relevant tools from an MCP server:

• [MCP] Handle Ollama's deviation from the OpenAI tool streaming spec by @hanouticelina in [#3140]
• [Tiny Agents] Add tools to config by @NielsRogge in [#3242]
• fix allowed tools by @Wauplin (direct commit on main)

🛠️ Small fixes and maintenance

🐛 Bug and typo fixes

• Fix bad total size after resuming download by @DKingAlpha in [#3234])
• bug fix: only extend path on window sys by @vealocia in [#3265]
• [Update] HF Jobs Documentation by @ariG23498 in [#3268]
• Improve Git Credential Helper Detection for Linux (GCM & libsecret support) by @danchev in [#3264]
• Make requests decode content by @rasmusfaber in [#3271]
• Add validation warnings for repository limits in upload_large_folder by @davanstrien in [#3280]
• Include HF_HUB_DISABLE_XET in the environment dump by @hanouticelina in [#3290]
• Add type to job owner by @drbh in [#3291]
• Update to use only summary bars for uploads when in notebooks by @hoytak in [#3243]
• Deprecate library/tags/task/... filtering in list_models by @Wauplin in [#3318]
• Added apps as a parameter to HfApi.list_models by @anirbanbasu in [#3322]
• Update error message to improve shell compatibility by @aopstudio in [#3333]
• docs: minor typo fix in /en/guides/manage-cache by @Manith-Ratnayake in [#3353]

🏗️ internal

• Prepare for v0.35 by @Wauplin in [#3261]
• fix-ish CI by @Wauplin (direct commit on main)
• Fix lfs test in CI by @Wauplin in [#3275]
• [Internal] Use ty type checker by @hanouticelina in [#3294]
• [Internal] fix tycheck quality by @hanouticelina in [#3320]
• Return early in is_jsonable if circular reference by @Wauplin in [#3348]

Community contributions

The following contributors have made changes to the library over the last release. Thank you!

• @DKingAlpha
  • Fix bad total size after resuming download (#3234) (#3248)
• @vealocia
  • bug fix: only extend path on window sys (#3265)
• @danchev
  • Improve Git Credential Helper Detection for Linux (GCM & libsecret support) (#3264)
• @rasmusfaber
  • Make requests decode content (#3271)
• @nyuuzyou
  • Fix bash history expansion in hf jobs example (#3277)
• @tre3x
  • Update jobs.md (#3297)
• @hoytak
  • Update to use only summary bars for uploads when in notebooks (#3243)
• @anirbanbasu
  • Added apps as a parameter to HfApi.list_models (#3322)
• @aopstudio
  • Update error message to improve shell compatibility (#3333)
• @Manith-Ratnayake
  • docs: minor typo fix in /en/guides/manage-cache (#3353)
• @Gnoale
  • feat: add scaleway inference provider (#3356)