Hugging Face Hub 1.x: تهيئة وكيل تنزيل HTTPX

في إعداد Transformers يستخدم huggingface_hub 1.x، يكون ناقل HTTP الخاص بـ Hub مكتوبًا بـ Python وهو 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 هذا. يستخدم المثال واجهة 1.0.0. استخدم نوع العميل الذي تتوقعه نسخة Hub الرئيسية المثبّتة؛ قد يستخدم جيل آخر مكتبة HTTP أخرى.

لاكتشاف الإعداد من البيئة، عيّن HTTP_PROXY وHTTPS_PROXY قبل تشغيل Python بدلًا من ذلك. يمكن لمستمع HTTP أن ينقل الطلبات إلى وجهات HTTPS.

للمصنع المتزامن نطاق محدد. يستخدم العملاء غير المتزامنين set_async_client_factory، بينما تستخدم عمليات نقل Xet واجهة خلفية منفصلة لا تستهلك مصنع Python هذا.

حدّد المرحلة الفاشلة — بيانات Hub الوصفية أو المحتوى المعاد توجيهه أو نقل Xet — قبل اختيار تهيئتها. يمكن لنموذج مخزّن في الذاكرة المؤقتة أن يتجاوز تلك الطلبات تمامًا.