الانتقال إلى huggingface_hub v2.0

huggingface_hub الإصدار 2.0 يستبدل تبعيته على HTTP بـ httpx2 ويحذف واجهات برمجة التطبيقات 1.x التي لم تعد مدعومة. أصبحت عملاء HTTP والاستثناءات تأتي من حزمة منفصلة.

لدعم كل من huggingface_hub الإصدار 1.x (بدءًا من الإصدار 1.30.0) والإصدار 2.x، استورد وحدة HTTP من huggingface_hub.utils:

from huggingface_hub.utils import get_session, httpx

try:
    response = get_session().get("https://huggingface.co/api/models/gpt2")
    response.raise_for_status()
except httpx.HTTPError:
    ...

استخدم هذا الاستيراد نفسه عند إنشاء عملاء مخصصين لـ set_client_factory() أو set_async_client_factory(). العملاء والاستثناءات من حزمة HTTP القديمة مختلفة عن تلك الموجودة في httpx2 ولا يمكن استخدامها بالتبادل.

httpx2 يستخدم مخزن شهادات الثقة الخاص بنظام التشغيل افتراضيًا. لا تزال حزم CA المخصصة المُعدّة عبر SSL_CERT_FILE أو SSL_CERT_DIR مدعومة. يجب أن يستهدف تكوين التسجيل httpx2 وhttpcore2 بدلاً من أسماء السجلات القديمة. راجع دليل الترحيل من المصدر للتفاصيل.

يتطلب الإصدار الإضافي oauth الآن authlib>=1.8.0 لدعم httpx2.

تمت إزالة واجهات برمجة التطبيقات غير المدعومة

• استخدم upload_folder بدلاً من upload_large_folder أو HfApi.upload_large_folder.
• استخدم duplicate_repo وset_space_volumes وdelete_space_volumes بدلاً من duplicate_space وrequest_space_storage وdelete_space_storage.
• استخدم parse_hf_uri بدلاً من repo_type_and_id_from_hf_id، وlist_models(search=...) بدلاً من model_name=....
• استخدم space_volumes بدلاً من space_storage في create_repo وduplicate_repo.
• استخدم InferenceEndpointType.AUTHENTICATED أو type="authenticated" بدلاً من PROTECTED أو type="protected".
• استخدم text_generation(stop=...) بدلاً من stop_sequences=...، ومرر سلسلة رموز أو None إلى InferenceClient بدلاً من قيمة منطقية.
• استخدم hf بدلاً من huggingface-cli؛ حيث تم استبدال hf repo وhf repo-files delete بـhf repos وhf repos delete-files.
• استخدم hf upload بدلاً من hf upload-large-folder؛ واستخدم --volume بدلاً من --storage لإنشاء المستودعات وتكرارها، و--status أو --label بدلاً من hf jobs ps --filter.
• تمت إزالة الخيار --claude الذي لم يعد مدعوماً في hf skills add وhf skills update. يتم تثبيت المهارات لـ Claude Code تلقائياً.

لمزيد من السياق، راجع مشروع httpx2، ووثائق httpx2، ودليل الانتقال من httpx إلى httpx2، وخطة الانتقال الخاصة بـ huggingface_hub.