Migration vers huggingface_hub v2.0

huggingface_hub v2.0 remplace sa dépendance HTTP par httpx2 et supprime les API 1.x obsolètes. Les clients HTTP et les exceptions proviennent désormais d’un package distinct.

Pour prendre en charge à la fois huggingface_hub v1.x (à partir de v1.30.0) et v2.x, importez le module HTTP depuis huggingface_hub.utils :

from huggingface_hub.utils import get_session, httpx

try:
    response = get_session().get("https://huggingface.co/api/models/gpt2")
    response.raise_for_status()
except httpx.HTTPError:
    ...

Utilisez cette même importation lors de la création de clients personnalisés pour set_client_factory() ou set_async_client_factory(). Les clients et les exceptions du paquet HTTP ancien sont distincts de ceux de httpx2 et ne peuvent pas être utilisés de manière interchangeable.

httpx2 utilise par défaut le magasin de confiance des certificats du système d’exploitation. Les bundles CA personnalisés configurés avec SSL_CERT_FILE ou SSL_CERT_DIR restent pris en charge. La configuration de la journalisation doit cibler httpx2 et httpcore2 au lieu des anciens noms de journalisateurs. Consultez le guide de migration amont pour plus de détails.

L'extra oauth nécessite désormais authlib>=1.8.0 pour la prise en charge de httpx2.

Suppression des API obsolètes

• Utilisez upload_folder plutôt que upload_large_folder ou HfApi.upload_large_folder.
• Utilisez duplicate_repo, set_space_volumes et delete_space_volumes à la place de duplicate_space, request_space_storage et delete_space_storage.
• Utilisez parse_hf_uri à la place de repo_type_and_id_from_hf_id, et list_models(search=...) à la place de model_name=....
• Utilisez space_volumes au lieu de space_storage dans create_repo et duplicate_repo.
• Utilisez InferenceEndpointType.AUTHENTICATED ou type="authenticated" à la place de PROTECTED ou type="protected".
• Utilisez text_generation(stop=...) au lieu de stop_sequences=..., et passez une chaîne de jetons ou None à InferenceClient au lieu d'un booléen.
• Utilisez hf à la place de huggingface-cli ; hf repo et hf repo-files delete sont remplacés par hf repos et hf repos delete-files.
• Utilisez hf upload à la place de hf upload-large-folder ; utilisez --volume à la place de --storage pour la création et la duplication de dépôts, et --status ou --label à la place de hf jobs ps --filter.
• L'option --claude obsolète de hf skills add et hf skills update a été supprimée. Les compétences sont désormais installées automatiquement pour Claude Code.

Pour plus de contexte, consultez le projet httpx2, la documentation de httpx2, le guide de transition de httpx vers httpx2 en amont, ainsi que le plan de transition de huggingface_hub.