Hugging Face Hub 1.x: configurare il proxy di download HTTPX

Configura la factory dei client di Hub 1.x o l'ambiente del processo prima di un download Transformers, tenendo conto dei percorsi async e Xet separati.

In un'installazione Transformers con huggingface_hub 1.x, il trasporto HTTP Python dell'Hub è HTTPX. Configura la sua factory di client sincroni prima di avviare la pipeline o il caricatore di modelli:

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)

Per i download consentiti di modelli pubblici, la lista di proxy HTTP fornisce candidati per questo URL di proxy HTTP. L'esempio usa l'API 1.0.0. Usa il tipo di client previsto dalla versione principale installata dell'Hub; un'altra generazione può usare un'altra libreria HTTP.

Per l'individuazione tramite ambiente, imposta invece HTTP_PROXY e HTTPS_PROXY prima di avviare Python. Un listener HTTP può trasportare richieste verso destinazioni HTTPS.

La factory sincrona ha un ambito definito. I client async usano set_async_client_factory, mentre i trasferimenti Xet usano un backend separato che non consuma questa factory Python.

Individua la fase non riuscita —metadati dell'Hub, contenuto reindirizzato o trasferimento Xet— prima di scegliere la configurazione. Un modello in cache può saltare del tutto quelle richieste.

Articoli correlati