# Migrar a huggingface_hub v2.0

`huggingface_hub` v2.0 reemplaza su dependencia HTTP con [`httpx2`](https://httpx2.pydantic.dev/) y elimina las APIs de 1.x obsoletas. Los clientes HTTP y las excepciones provienen ahora de un paquete separado.

Para soportar tanto `huggingface_hub` v1.x (a partir de v1.30.0) como v2.x, importa el módulo HTTP desde `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:
    ...
```

Use este mismo import al crear clientes personalizados para [set_client_factory()](/docs/huggingface_hub/v2.4.0/es/package_reference/utilities#huggingface_hub.set_client_factory) o [set_async_client_factory()](/docs/huggingface_hub/v2.4.0/es/package_reference/utilities#huggingface_hub.set_async_client_factory). Los clientes y las excepciones del antiguo paquete HTTP son distintos de los de `httpx2` y no se pueden usar de forma intercambiable.

`httpx2` utiliza el almacén de confianza de certificados del sistema operativo de forma predeterminada. Los paquetes de CA personalizados configurados con `SSL_CERT_FILE` o `SSL_CERT_DIR` siguen siendo compatibles. La configuración de registros debe dirigirse a `httpx2` y `httpcore2` en lugar de los nombres de registrador antiguos. Consulte la [guía de migración de la fuente](https://httpx2.pydantic.dev/migration/) para obtener más detalles.

El extra `oauth` ahora requiere `authlib>=1.8.0` para el soporte de `httpx2`.

## Se eliminaron las APIs obsoletas

- Usa `upload_folder` en lugar de `upload_large_folder` o `HfApi.upload_large_folder`.
- Usa `duplicate_repo`, `set_space_volumes` y `delete_space_volumes` en lugar de `duplicate_space`, `request_space_storage` y `delete_space_storage`.
- Usa `parse_hf_uri` en lugar de `repo_type_and_id_from_hf_id`, y `list_models(search=...)` en lugar de `model_name=...`.
- Usa `space_volumes` en lugar de `space_storage` en `create_repo` y `duplicate_repo`.
- Use `InferenceEndpointType.AUTHENTICATED` o `type="authenticated"` en lugar de `PROTECTED` o `type="protected"`.
- Use `text_generation(stop=...)` en lugar de `stop_sequences=...`, y pase una cadena de tokens o `None` a `InferenceClient` en lugar de un booleano.
- Usa `hf` en lugar de `huggingface-cli`; `hf repo` y `hf repo-files delete` se han reemplazado por `hf repos` y `hf repos delete-files`.
- Usa `hf upload` en lugar de `hf upload-large-folder`; usa `--volume` en lugar de `--storage` para la creación y duplicación de repositorios, y `--status` o `--label` en lugar de `hf jobs ps --filter`.
- La opción `--claude` obsoleta de `hf skills add` y `hf skills update` se ha eliminado. Las skills se instalan automáticamente para Claude Code.

Para obtener más contexto, consulte el proyecto [`httpx2`](https://github.com/pydantic/httpx2), la documentación de [`httpx2`](https://pydantic.dev/docs/httpx2/), la [guía de transición de `httpx` a `httpx2`](https://httpx2.pydantic.dev/migration/) y el [plan de transición de `huggingface_hub`](https://github.com/huggingface/huggingface_hub/issues/4802).