Hugging Face Hub 1.x: HTTPX 다운로드 프록시 구성

Transformers 다운로드 전에 Hub 1.x 클라이언트 팩터리나 프로세스 환경을 구성하고, 별도의 async 및 Xet 경로를 고려하세요.

huggingface_hub 1.x를 사용하는 Transformers 환경에서 Hub의 Python HTTP 전송은 HTTPX입니다. 파이프라인이나 모델 로더를 시작하기 전에 동기 클라이언트 팩터리를 구성하세요:

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 프록시 목록이 이 HTTP 프록시 URL의 후보를 제공합니다. 예제는 1.0.0 API를 사용합니다. 설치된 Hub 주 버전이 기대하는 클라이언트 유형을 사용하세요. 다른 세대는 다른 HTTP 라이브러리를 사용할 수 있습니다.

환경 기반 검색을 위해서는 대신 Python을 시작하기 전에 HTTP_PROXY와 HTTPS_PROXY를 설정하세요. HTTP 리스너는 요청을 HTTPS 대상으로 전달할 수 있습니다.

동기 팩터리에는 정해진 범위가 있습니다. async 클라이언트는 set_async_client_factory를 사용하고, Xet 전송은 이 Python 팩터리를 사용하지 않는 별도 backend를 사용합니다.

구성을 선택하기 전에 실패한 단계—Hub 메타데이터, 리디렉션된 콘텐츠 또는 Xet 전송—를 파악하세요. 캐시된 모델은 해당 요청을 완전히 건너뛸 수 있습니다.

관련 글