Migrar a huggingface_hub v2.0

huggingface_hub v2.0 reemplaza su dependencia HTTP con httpx2 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:

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() o 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 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, la documentación de httpx2, la guía de transición de httpx a httpx2 y el plan de transición de huggingface_hub.