Hugging Face Hub 1.x: configurar el proxy de descarga de HTTPX

En una configuración de Transformers con huggingface_hub 1.x, el transporte HTTP de Python del Hub es HTTPX. Configure su fábrica de clientes síncronos antes de iniciar el pipeline o el cargador de modelos:

import httpx
from huggingface_hub import set_client_factory

def make_hub_client():
    return httpx.Client(
        proxy='http://proxy.example:8080',
        follow_redirects=True,
        timeout=30,
    )

set_client_factory(make_hub_client)

Para descargas permitidas de modelos públicos, la lista de proxies HTTP proporciona candidatos para esta URL de proxy HTTP. El ejemplo usa la API 1.0.0. Utilice el tipo de cliente que espera la versión principal del Hub instalada; otra generación puede usar otra biblioteca HTTP.

Para el descubrimiento basado en el entorno, defina HTTP_PROXY y HTTPS_PROXY antes de iniciar Python. Un escucha HTTP puede transportar solicitudes a destinos HTTPS.

La fábrica síncrona tiene un alcance definido. Los clientes async usan set_async_client_factory, mientras que las transferencias Xet usan un backend independiente que no consume esta fábrica de Python.

Identifique la etapa fallida —metadatos del Hub, contenido redirigido o transferencia Xet— antes de elegir la configuración. Un modelo en caché puede omitir por completo esas solicitudes.