Hugging Face Hub 1.x: configurar o proxy de download HTTPX

Numa configuração do Transformers com huggingface_hub 1.x, o transporte HTTP Python do Hub é o HTTPX. Configure a sua fábrica de clientes síncronos antes de iniciar o pipeline ou o carregador 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 downloads permitidos de modelos públicos, a lista de proxies HTTP fornece candidatos para este URL de proxy HTTP. O exemplo usa a API 1.0.0. Use o tipo de cliente que a versão principal instalada do Hub espera; outra geração pode usar outra biblioteca HTTP.

Para descoberta baseada no ambiente, defina HTTP_PROXY e HTTPS_PROXY antes de iniciar o Python. Um ouvinte HTTP pode transportar pedidos para destinos HTTPS.

A fábrica síncrona tem um âmbito definido. Os clientes async usam set_async_client_factory, enquanto as transferências Xet usam um backend separado que não consome esta fábrica Python.

Identifique a etapa falhada — metadados do Hub, conteúdo redirecionado ou transferência Xet — antes de escolher a configuração. Um modelo em cache pode ignorar completamente esses pedidos.