Hugging Face Hub 1.x: настройка прокси для загрузки через HTTPX

Настройте фабрику клиентов Hub 1.x или окружение процесса перед загрузкой Transformers, учитывая отдельные пути async и Xet.

В конфигурации Transformers с huggingface_hub 1.x Python HTTP-транспортом Hub служит HTTPX. Настройте фабрику синхронных клиентов до запуска pipeline или загрузчика модели:

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)

Для разрешённых загрузок публичных моделей список HTTP-прокси даёт кандидатов для этого URL HTTP-прокси. В примере используется API 1.0.0. Используйте тип клиента, которого ожидает установленная основная версия Hub; другое поколение может применять другую HTTP-библиотеку.

Для обнаружения через окружение задайте HTTP_PROXY и HTTPS_PROXY до запуска Python. HTTP-прослушиватель может передавать запросы к адресам HTTPS.

У синхронной фабрики определённая область действия. Async-клиенты используют set_async_client_factory, а передачи Xet — отдельный backend, который не задействует эту фабрику Python.

Определите сбойный этап — метаданные Hub, перенаправленное содержимое или передачу Xet — прежде чем выбирать конфигурацию. Модель в кэше может полностью пропустить эти запросы.

Похожие статьи