Hub documentation

دفاتر Jupyter على Hugging Face Hub

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

دفاتر Jupyter على Hugging Face Hub

دفاتر Jupyter هي تنسيق شائع جدًا لمشاركة أكواد وتحليل البيانات في مجال تعلّم الآلة وعلوم البيانات. وهي وثائق تفاعلية يمكن أن تحتوي على أكواد، وتصورات بيانية، ونصوص.

فتح النماذج المفتوحة في Google Colab وKaggle

عند زيارتك لصفحة نموذج على Hugging Face Hub، ستجد زرًا جديدًا بعنوان “Google Colab”/ “Kaggle” ضمن قائمة “Use this model” المنسدلة. عند النقر على هذا الزر، سيتم إنشاء دفتر ملاحظات جاهز للتشغيل يحتوي على كود أساسي لتحميل النموذج واختباره. وهذا مثالي للتطوير السريع، أو اختبار الاستدلال، أو تجارب الضبط الدقيق — كل ذلك دون مغادرة متصفحك.

Google Colab and Kaggle option for models on the Hub

يمكن للمستخدمين أيضًا الوصول إلى دفتر ملاحظات جاهز للتشغيل عن طريق إضافة /colab إلى عنوان URL لبطاقة النموذج. كمثال، بالنسبة لأحدث نموذج Gemma 3 4B IT، يمكن الوصول إلى دفتر ملاحظات Colab المقابل عن طريق أخذ عنوان URL لبطاقة النموذج: https://huggingface.co/google/gemma-3-4b-it

ثم إضافة /colab إليه: https://huggingface.co/google/gemma-3-4b-it/colab

وبالمثل بالنسبة إلى kaggle: https://huggingface.co/google/gemma-3-4b-it/kaggle

إذا تضمن مستودع نموذج ملفًا باسم notebook.ipynb، فسنستخدمه لـ Colab و Kaggle بدلاً من محتوى الدفتر المولّد تلقائيًا. يمكن لمطوّري النماذج تقديم أمثلة مخصصة، أو شروحات تفصيلية، أو حالات استخدام متقدمة، مع الاستفادة في الوقت نفسه من تكامل Colab بنقرة واحدة. NousResearch/Genstruct-7B هو مثال على ذلك.

عرض دفاتر Jupyter بصيغة .ipynb على Hub

في الخلفية، ملفات Jupyter Notebook (التي تُشارك عادةً بامتداد .ipynb) هي ملفات JSON. ورغم أنه من الممكن عرض هذه الملفات مباشرةً، إلا أنها ليست صيغة مصممة للقراءة البشرية. يدعم Hub عرض الدفاتر المضافة إلى Hub. وهذا يعني أن الدفاتر تُعرض بصيغة قابلة للقراءة البشرية.

Before and after notebook rendering

ستُعرض الدفاتر (Notebooks) عند تضمينها في أي نوع من المستودعات على Hub. ويشمل ذلك النماذج (models) ومجموعات البيانات (datasets) ومساحات (Spaces).

إطلاق في Google Colab

Google Colab هو بيئة Jupyter Notebook مجانية لا تتطلب أي إعداد وتعمل بالكامل في السحابة. وهو طريقة رائعة لتشغيل Jupyter Notebooks دون الحاجة إلى تثبيت أي شيء على جهازك المحلي.

تُمنح جميع ملفات .ipynb المستضافة على Hub تلقائيًا زرًا بعنوان “فتح في Colab”. ويتيح لك ذلك فتح الدفتر في Colab بنقرة واحدة.

Update on GitHub