Hugging Face Hub 1.x: Den HTTPX-Downloadproxy konfigurieren
Konfigurieren Sie die Hub-1.x-Client-Factory oder die Prozessumgebung vor einem Transformers-Download und berücksichtigen Sie getrennte Async- und Xet-Pfade.
In einem Transformers-Setup mit huggingface_hub 1.x ist der Python-HTTP-Transport des Hub HTTPX. Konfigurieren Sie dessen synchrone Client-Factory, bevor die Pipeline oder der Modell-Loader startet:
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 erlaubte Downloads öffentlicher Modelle liefert die HTTP-Proxy-Liste Kandidaten für diese HTTP-Proxy-URL. Das Beispiel nutzt die API 1.0.0. Verwenden Sie den Clienttyp, den die installierte Hub-Hauptversion erwartet; eine andere Generation kann eine andere HTTP-Bibliothek verwenden.
Für umgebungsbasierte Ermittlung setzen Sie stattdessen HTTP_PROXY und HTTPS_PROXY, bevor Python startet. Ein HTTP-Listener kann Anfragen an HTTPS-Ziele weiterreichen.
Die synchrone Factory hat einen definierten Geltungsbereich. Async-Clients verwenden set_async_client_factory, während Xet-Transfers ein separates Backend nutzen, das diese Python-Factory nicht verwendet.
Bestimmen Sie die fehlgeschlagene Stufe – Hub-Metadaten, umgeleiteter Inhalt oder Xet-Transfer –, bevor Sie die Konfiguration wählen. Ein zwischengespeichertes Modell kann diese Anfragen vollständig überspringen.