Hugging Face Hub 1.x : configurer le proxy de téléchargement HTTPX

Dans une installation Transformers utilisant huggingface_hub 1.x, le transport HTTP Python du Hub est HTTPX. Configurez sa fabrique de clients synchrones avant de lancer le pipeline ou le chargeur de modèle :

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)

Pour les téléchargements autorisés de modèles publics, la liste de proxys HTTP fournit des candidats pour cette URL de proxy HTTP. L'exemple utilise l'API 1.0.0. Utilisez le type de client attendu par la version majeure installée du Hub ; une autre génération peut recourir à une autre bibliothèque HTTP.

Pour la découverte par l'environnement, définissez plutôt HTTP_PROXY et HTTPS_PROXY avant de lancer Python. Un écouteur HTTP peut acheminer des requêtes vers des destinations HTTPS.

La fabrique synchrone a une portée définie. Les clients async utilisent set_async_client_factory, tandis que les transferts Xet passent par un backend distinct qui ne consomme pas cette fabrique Python.

Identifiez l'étape en échec — métadonnées du Hub, contenu redirigé ou transfert Xet — avant de choisir sa configuration. Un modèle en cache peut ignorer entièrement ces requêtes.