Hugging Face Hub 1.x: konfigurera HTTPX-nedladdningsproxyn

Konfigurera Hub 1.x-klientfabriken eller processmiljön före en Transformers-nedladdning och ta hänsyn till separata async- och Xet-vägar.

I en Transformers-installation med huggingface_hub 1.x är Hubs Python HTTP-transport HTTPX. Konfigurera dess synkrona klientfabrik innan pipelinen eller modellinläsaren startar:

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)

För tillåtna nedladdningar av offentliga modeller tillhandahåller HTTP-proxylistan kandidater för denna HTTP-proxy-URL. Exemplet använder API:et 1.0.0. Använd den klienttyp som den installerade huvudversionen av Hub förväntar sig; en annan generation kan använda ett annat HTTP-bibliotek.

För miljöbaserad upptäckt anger du i stället HTTP_PROXY och HTTPS_PROXY innan Python startar. En HTTP-lyssnare kan bära förfrågningar till HTTPS-mål.

Den synkrona fabriken har ett definierat omfång. Async-klienter använder set_async_client_factory, medan Xet-överföringar använder en separat backend som inte förbrukar denna Python-fabrik.

Identifiera steget som misslyckades — Hub-metadata, omdirigerat innehåll eller Xet-överföring — innan du väljer konfiguration. En cachad modell kan hoppa över dessa förfrågningar helt.

Relaterade artiklar