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

[دفاتر Jupyter](https://jupyter.org/) هي تنسيق شائع جدًا لمشاركة أكواد وتحليل البيانات في مجال تعلّم الآلة وعلوم البيانات. وهي وثائق تفاعلية يمكن أن تحتوي على أكواد، وتصورات بيانية، ونصوص.

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

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

![Google Colab and Kaggle option for models on the Hub](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/hf-google-colab/gemma3-4b-it-dark.png)

يمكن للمستخدمين أيضًا الوصول إلى دفتر ملاحظات جاهز للتشغيل عن طريق إضافة /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](https://huggingface.co/NousResearch/Genstruct-7B) هو مثال على ذلك.

![](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/hf-google-colab/genstruct-notebook-dark.png)

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

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

![Before and after notebook rendering](https://huggingface.co/blog/assets/135_notebooks-hub/before_after_notebook_rendering.png)

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

### إطلاق في Google Colab

[Google Colab](https://colab.google/) هو بيئة Jupyter Notebook مجانية لا تتطلب أي إعداد وتعمل بالكامل في السحابة. وهو طريقة رائعة لتشغيل Jupyter Notebooks دون الحاجة إلى تثبيت أي شيء على جهازك المحلي.

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