# Migration vers huggingface_hub v2.0

`huggingface_hub` v2.0 remplace sa dépendance HTTP par [`httpx2`](https://httpx2.pydantic.dev/) 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` :

```python
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()](/docs/huggingface_hub/main/fr/package_reference/utilities#huggingface_hub.set_client_factory) ou [set_async_client_factory()](/docs/huggingface_hub/main/fr/package_reference/utilities#huggingface_hub.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](https://httpx2.pydantic.dev/migration/) 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`](https://github.com/pydantic/httpx2), la documentation de [`httpx2`](https://pydantic.dev/docs/httpx2/), le [guide de transition de `httpx` vers `httpx2`](https://httpx2.pydantic.dev/migration/) en amont, ainsi que le [plan de transition de `huggingface_hub`](https://github.com/huggingface/huggingface_hub/issues/4802).