Skip to content

Upgrading huggingface-hub 0.32 to 0.33

Breaking0.32.6 → 0.33.5Breaking4New4Changed2Fixed12Other6

Full comparisonBack to huggingface-hub
BreakingUpgrade verdict

4 breaking changes.

In plain terms
  • Configuration values that were previously grouped under a nested section must now be placed at the top level of the config file.
  • The Tiny-Agent configuration file format changed. Settings that used to be nested are now at the top level, and headers are now set directly instead of inside a nested options block.
  • HTTP headers for the MCP server are now specified at the top level of the server entry rather than nested under options.requestInit.
  • Environment variable substitution now uses the input id to look up values, so existing environment-based configuration may need adjusting.
Must act Top 3 of 4 that need code or config changes

What you must change

Breaking4
Removes the nested config mapping so all Tiny-Agent config values now live at the root level.
0.33.2GitHub ReleaseSummarizedView source
Switches Tiny-Agent to the VSCode MCP format and fixes headers handling, moving config to root level and headers out of options.requestInit.
agent.json
0.33.2GitHub ReleaseSummarizedView source
Moves headers to the root level instead of inside options.requestInit.
options.requestInit
0.33.2GitHub ReleaseSummarizedView source
Updates how values are pulled from ENV, now based on the input id.
0.33.2GitHub ReleaseSummarizedView source

API changes

Generated by DepDelta from published Python source. Not mixed with prose notes.

  • changed: field InferenceProviderMapping.status: Literal['live', 'staging'] → field InferenceProviderMapping.status: Literal['error', 'live', 'staging']
  • changed: field ModelInfo.inference: Optional[Literal['warm', 'cold', 'frozen']] → field ModelInfo.inference: Optional[Literal['warm']]
  • changed: field ModelInfo.inference_provider_mapping: Optional[Dict[str, InferenceProviderMapping]] → field ModelInfo.inference_provider_mapping: Optional[List[InferenceProviderMapping]]
  • changed: method HfApi.list_models(*, filter: Union[str, Iterable[str], None]=…, author: Optional[str]=…, gated: Optional[bool]=…, inference: Optional[Literal['cold', 'frozen', 'warm']]=…, library: Optional[Union[str, List[str]]]=…, language: Optional[Union[str, List[str]]]=…, model_name: Optional[str]=…, task: Optional[Union[str, List[str]]]=…, trained_dataset: Optional[Union[str, List[str]]]=…, tags: Opt… → method HfApi.list_models(*, filter: Union[str, Iterable[str], None]=…, author: Optional[str]=…, gated: Optional[bool]=…, inference: Optional[Literal['warm']]=…, inference_provider: Optional[Union[Literal['all'], PROVIDER_T, List[PROVIDER_T]]]=…, library: Optional[Union[str, List[str]]]=…, language: Optional[Union[str, List[str]]]=…, model_name: Optional[str]=…, task: Optional[Union[str, List[str]…
  • added: field InferenceProviderMapping.provider: PROVIDER_T
  • added: field InferenceProviderMapping.type: Optional[Literal['single-model', 'tag-filter']]