Hub documentation

كيفية إضافة مساحة إلى ArXiv

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

كيفية إضافة مساحة إلى ArXiv

تتيح العروض التوضيحية على Hugging Face Spaces لجمهور واسع تجربة أحدث أبحاث تعلم الآلة دون كتابة أي كود. تعاونت Hugging Face مع ArXiv لدمج هذه العروض التوضيحية مباشرةً إلى جانب الأوراق البحثية على ArXiv!

بفضل هذا التكامل، أصبح بإمكان المستخدمين الآن العثور على أكثر العروض التوضيحية شيوعًا لورقة بحثية على صفحة ملخصها في arXiv. على سبيل المثال، إذا كنت ترغب في تجربة العروض التوضيحية لنموذج تصنيف المستندات LayoutLM، يمكنك الانتقال إلى صفحة ورقة LayoutLM على arXiv، والانتقال إلى تبويب العرض التوضيحي. ستجد عروضًا توضيحية مفتوحة المصدر بُنيت بواسطة مجتمع تعلم الآلة لهذا النموذج، والتي يمكنك تجربتها فورًا في متصفحك:

سنستعرض طريقتين مختلفتين لإضافة مساحتك إلى ArXiv وظهورها في تبويب Demos.

المتطلبات المسبقة

  • يوجد بحث قائم على ArXiv ترغب في إنشاء عرض توضيحي له
  • لقد بنيتَ (أو يمكنك بناء) عرضاً توضيحياً للنموذج على Spaces

الطريقة 1 (موصى بها): الربط من ملف README الخاص بالمساحة

أبسط طريقة لإضافة مساحة إلى ورقة بحثية على ArXiv هي تضمين رابط الورقة في ملف README الخاص بالمساحة (README.md). ومن الجيد تضمين اقتباس كامل أيضاً. يمكنك الاطلاع على مثال للرابط والاقتباس في ملف README الخاص بمساحة تقسيم صدى القلب.

وهذا كل شيء! يجب أن يظهر مساحتك في تبويب العرض التجريبي بجانب الورقة على ArXiv خلال دقائق قليلة 🤗

الطريقة 2: ربط نموذج ذي صلة

يمكن استخدام نهج بديل لربط المساحات (Spaces) بالأوراق البحثية من خلال ربط نموذج وسيط بالمساحة. ويتطلب ذلك أن تكون الورقة البحثية مرتبطة بنموذج موجود على Hugging Face Hub (أو يمكن رفعه إليه).

  1. أولاً، ارفع النموذج المرتبط بورقة ArXiv إلى Hugging Face Hub إذا لم يكن موجودًا بالفعل. (التعليمات التفصيلية هنا)

  2. عند كتابة بطاقة النموذج (README.md) للنموذج، شمل رابطًا إلى ورقة ArXiv. يُعدّ من الممارسات الجيدة تضمين اقتباس كامل أيضًا. يمكنك الاطلاع على مثال لرابط واقتباس في بطاقة نموذج LayoutLM

    ملاحظة: يمكنك التحقق من نجاح تنفيذ هذه الخطوة عن طريق ملاحظة ظهور زر ArXiv فوق بطاقة النموذج. في حالة LayoutLM، ينص الزر على: “arxiv:1912.13318” ويرتبط بورقة LayoutLM على ArXiv.

  3. ثم، أنشئ عرضًا توضيحيًا على Spaces يحمّل هذا النموذج. يجب أن يتضمن الكود في مكانٍ ما اسم النموذج حتى يتمكن Hugging Face من اكتشاف أن مساحة مرتبطة به.

    على سبيل المثال، يحمّل مساحة docformer_for_document_classification نموذج LayoutLM على هذا النحو ويتضمن السلسلة "microsoft/layoutlm-base-uncased":

    from transformers import LayoutLMForTokenClassification
    
    layoutlm_dummy = LayoutLMForTokenClassification.from_pretrained("microsoft/layoutlm-base-uncased", num_labels=1)

    ملاحظة: إليك نظرة عامة حول بناء العروض التوضيحية على Hugging Face Spaces، وفيما يلي تعليمات أكثر تحديدًا لـ Gradio و Streamlit.

  4. بمجرد اكتمال بناء مساحة (Space) الخاصة بك، سيقوم Hugging Face باكتشاف ارتباطها بالنموذج. يجب أن يظهر زر “Linked Models” في الزاوية العلوية اليمنى من المساحة، كما هو موضح هنا:

    ملاحظة: يمكنك أيضًا إضافة النماذج المرتبطة يدويًا من خلال تحديثها بشكل صريح في بيانات الوصف (README) الخاصة بالمساحة، كما هو موضح هنا.

يجب أن يظهر مساحتك في تبويب العرض التجريبي بجانب الورقة على ArXiv خلال بضع دقائق 🤗

Update on GitHub