توفِّر هذه الصفحة تعليمات الإعداد لاستخدام Gemma في Colab. يمكن استخدام
تنطبق التعليمات على بيئات التطوير الأخرى أيضًا.
الحصول على إذن بالوصول إلى Gemma
قبل استخدام Gemma للمرة الأولى، يجب طلب الوصول إلى
النموذج من خلال Kaggle. كجزء من العملية، سيتعين عليك استخدام Kaggle
لقبول سياسة استخدام Gemma وبنود الترخيص.
إذا لم يكن لديك حساب Kaggle بالفعل، فيمكنك التسجيل للحصول على واحد في
kaggle.com. ثم أكمل الخطوات التالية:
لإكمال الدليل التوجيهي عن Colab، يجب أن يكون لديك بيئة تشغيل Colab تتضمن معلومات كافية.
الموارد لتشغيل نموذج Gemma. للبدء، يمكنك
استخدام وحدة معالجة رسومات من النوع T4:
في أعلى يسار نافذة Colab، اختَر بإحدى القنوات local
(خيارات الاتصال الإضافية).
اختَر تغيير نوع بيئة التشغيل.
ضِمن مسرِّع الأجهزة، اختَر وحدة معالجة الرسومات T4.
ضبط مفتاح واجهة برمجة التطبيقات
لاستخدام Gemma، يجب عليك تقديم اسم مستخدم Kaggle ومفتاح واجهة برمجة تطبيقات Kaggle. إلى
لإنشاء هذه القيم وتهيئتها، اتبع الخطوات التالية:
لإنشاء مفتاح واجهة برمجة تطبيقات Kaggle، انتقل إلى علامة التبويب الحساب لمستخدم Kaggle
ملفك الشخصي واختَر إنشاء رمز مميّز جديد. سيؤدي هذا إلى بدء تنزيل
ملف واحد (kaggle.json) يحتوي على بيانات اعتماد واجهة برمجة التطبيقات.
افتح "kaggle.json" في محرِّر نصوص. يجب أن يبدو المحتوى على شكل
التالي:
في Colab، اختَر الأسرار (🔑) وأضِف اسم مستخدم Kaggle وKaggle
مفتاح واجهة برمجة التطبيقات. تخزين اسم المستخدم الخاص بك تحت الاسم KAGGLE_USERNAME وواجهة برمجة التطبيقات الخاصة بك
تحت اسم KAGGLE_KEY.
لقد أصبحت جاهزًا لإكمال خطوات الإعداد المتبقية في Colab. إذا كنت
من خلال برنامج Colab التعليمي، انتقِل إلى Colab واضبط متغيّرات البيئة.
تاريخ التعديل الأخير: 2024-08-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-05 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Gemma setup\n\nThis page provides setup instructions for using Gemma in Colab. Some of the\ninstructions are applicable to other development environments as well.\n\nGet access to Gemma\n-------------------\n\nBefore using Gemma for the first time, you must request access to the\nmodel through Kaggle. As part of the process, you'll have to use a Kaggle\naccount to accept the Gemma use policy and license terms.\n\nIf you don't already have a Kaggle account, you can register for one at\n[kaggle.com](https://www.kaggle.com). Then complete the following steps:\n\n1. Go to the [Gemma model card](https://www.kaggle.com/models/google/gemma) and select **Request Access**.\n2. Complete the consent form and accept the terms and conditions.\n\nSelect a Colab runtime\n----------------------\n\nTo complete a Colab tutorial, you must have a Colab runtime with sufficient\nresources to run the Gemma model. To [get started](./get_started), you can\nuse a T4 GPU:\n\n1. In the upper-right of the Colab window, select ▾ (**Additional connection options**).\n2. Select **Change runtime type**.\n3. Under **Hardware accelerator** , select **T4 GPU**.\n\nConfigure your API key\n----------------------\n\nTo use Gemma, you must provide your Kaggle username and a Kaggle API key. To\ngenerate and configure these values, follow these steps:\n\n1. To generate a Kaggle API key, go to the **Account** tab of your Kaggle [user\n profile](https://www.kaggle.com/settings) and select **Create New Token** . This will trigger the download of a `kaggle.json` file containing your API credentials.\n2. Open `kaggle.json` in a text editor. The contents should look something like\n this:\n\n {\"username\":\"your_username\",\"key\":\"012345678abcdef012345678abcdef1a\"}\n\n3. In Colab, select **Secrets** (🔑) and add your Kaggle username and Kaggle\n API key. Store your username under the name `KAGGLE_USERNAME` and your API\n key under the name `KAGGLE_KEY`.\n\n | **Note:** Kaggle notebooks have a key storage feature under **Add-ons** \\\u003e **Secrets**, along with instructions for accessing stored keys.\n\nNow you're ready to complete the remaining setup steps in Colab. If you're\nworking through a Colab tutorial, go to Colab and set the environment variables.\n| **Tip:** As an alternative to setting environment variables, you can use `kagglehub` to [authenticate](https://github.com/Kaggle/kagglehub?tab=readme-ov-file#authenticate)."]]
