From 967272040dbb12f84a2a047d0f60d1d48e5c1e45 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Thu, 22 Aug 2024 23:21:03 +0300 Subject: [PATCH 01/17] Add docs/source/ar/installation.md to Add_docs_source_ar_installation.md --- docs/source/ar/installation.md | 246 +++++++++++++++++++++++++++++++++ 1 file changed, 246 insertions(+) create mode 100644 docs/source/ar/installation.md diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md new file mode 100644 index 000000000000..855308f733ea --- /dev/null +++ b/docs/source/ar/installation.md @@ -0,0 +1,246 @@ +## التثبيت + +قم بتثبيت مكتبة 🤗 Transformers لمكتبة التعلم العميق التي تعمل معها، وقم بإعداد ذاكرة التخزين المؤقت الخاصة بك، وقم بإعداد 🤗 Transformers للعمل دون اتصال (اختياري). + +تم اختبار 🤗 Transformers على Python 3.6+، وPyTorch 1.1.0+، وTensorFlow 2.0+، وFlax. اتبع تعليمات التثبيت أدناه لمكتبة التعلم العميق التي تستخدمها: + +* تعليمات تثبيت [PyTorch](https://pytorch.org/get-started/locally/). +* تعليمات تثبيت [TensorFlow 2.0](https://www.tensorflow.org/install/pip). +* تعليمات تثبيت [Flax](https://flax.readthedocs.io/en/latest/). + +## التثبيت باستخدام pip + +يجب عليك تثبيت 🤗 Transformers في [بيئة افتراضية](https://docs.python.org/3/library/venv.html). إذا لم تكن معتادًا على البيئات الافتراضية في Python، فراجع هذا [الدليل](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/). تجعل البيئة الافتراضية من السهل إدارة المشاريع المختلفة، وتجنب مشكلات التوافق بين التبعيات. + +ابدأ بإنشاء بيئة افتراضية في دليل مشروعك: + +```bash +python -m venv .env +``` + +قم بتنشيط البيئة الافتراضية. على Linux وMacOs: + +```bash +source .env/bin/activate +``` + +قم بتنشيط البيئة الافتراضية على Windows: + +```bash +.env/Scripts/activate +``` + +الآن أنت مستعد لتثبيت 🤗 Transformers باستخدام الأمر التالي: + +```bash +pip install transformers +``` + +للحصول على الدعم الخاص بـ CPU فقط، يمكنك تثبيت 🤗 Transformers ومكتبة التعلم العميق في خطوة واحدة. على سبيل المثال، قم بتثبيت 🤗 Transformers وPyTorch باستخدام: + +```bash +pip install 'transformers[torch]' +``` + +🤗 Transformers وTensorFlow 2.0: + +```bash +pip install 'transformers[tf-cpu]' +``` + + + +لمستخدمي M1 / ARM + +ستحتاج إلى تثبيت ما يلي قبل تثبيت TensorFLow 2.0 +```bash +brew install cmake +brew install pkg-config +``` + + + +🤗 Transformers وFlax: + +```bash +pip install 'transformers[flax]' +``` + +أخيرًا، تحقق مما إذا كان 🤗 Transformers قد تم تثبيته بشكل صحيح عن طريق تشغيل الأمر التالي. سيقوم بتنزيل نموذج مدرب مسبقًا: + +```bash +python -c "from transformers import pipeline; print(pipeline('sentiment-analysis')('we love you'))" +``` + +ثم قم بطباعة التسمية والنتيجة: + +```bash +[{'label': 'POSITIVE', 'score': 0.9998704791069031}] +``` + +## التثبيت من المصدر + +قم بتثبيت 🤗 Transformers من المصدر باستخدام الأمر التالي: + +```bash +pip install git+https://github.com/huggingface/transformers +``` + +يقوم هذا الأمر بتثبيت إصدار `main` النازف بدلاً من الإصدار `stable` الأحدث. يعد إصدار `main` مفيدًا للبقاء على اطلاع دائم بأحدث التطورات. على سبيل المثال، إذا تم إصلاح خطأ منذ الإصدار الرسمي الأخير ولكن لم يتم طرح إصدار جديد بعد. ومع ذلك، فإن هذا يعني أن إصدار `main` قد لا يكون مستقرًا دائمًا. نسعى جاهدين للحفاظ على تشغيل إصدار `main`، ويتم حل معظم المشكلات عادةً في غضون بضع ساعات أو يوم. إذا واجهتك مشكلة، يرجى فتح [قضية](https://github.com/huggingface/transformers/issues) حتى نتمكن من إصلاحها في أقرب وقت ممكن! + +تحقق مما إذا كان 🤗 Transformers قد تم تثبيته بشكل صحيح عن طريق تشغيل الأمر التالي: + +```bash +python -c "from transformers import pipeline; print(pipeline('sentiment-analysis')('I love you'))" +``` + +تحقق مما إذا كان 🤗 Transformers قد تم تثبيته بشكل صحيح عن طريق تشغيل الأمر التالي: + +```bash +python -c "from transformers import pipeline; print(pipeline('sentiment-analysis')('I love you'))" +``` + +## التثبيت القابل للتحرير + +ستحتاج إلى تثبيت قابل للتحرير إذا كنت ترغب في: + +* استخدام إصدار `main` من كود المصدر. +* المساهمة في 🤗 Transformers وتحتاج إلى اختبار التغييرات في الكود. + +قم باستنساخ المستودع وقم بتثبيت 🤗 Transformers باستخدام الأوامر التالية: + +```bash +git clone https://github.com/huggingface/transformers.git +cd transformers +pip install -e . +``` + +سترتبط هذه الأوامر مجلد المستودع الذي قمت باستنساخه ومسارات مكتبة Python. الآن، سيبحث Python داخل المجلد الذي قمت باستنساخه بالإضافة إلى مسارات المكتبة العادية. على سبيل المثال، إذا تم تثبيت حزم Python الخاصة بك عادةً في `~/anaconda3/envs/main/lib/python3.7/site-packages/`, فسيقوم Python أيضًا بالبحث في المجلد الذي قمت باستنساخه: `~/transformers/`. + + + +يجب عليك الاحتفاظ بمجلد `transformers` إذا كنت تريد الاستمرار في استخدام المكتبة. + + + +الآن يمكنك تحديث المستنسخ الخاص بك بسهولة إلى أحدث إصدار من 🤗 Transformers باستخدام الأمر التالي: + +```bash +cd ~/transformers/ +git pull +``` + +ستجد بيئة Python الإصدار `main` من 🤗 Transformers في المرة التالية التي تقوم فيها بتشغيله. + +## التثبيت باستخدام conda + +قم بالتثبيت من قناة conda `conda-forge`: + +```bash +conda install conda-forge::transformers +``` + +## إعداد ذاكرة التخزين المؤقت + +يتم تنزيل النماذج المدربة مسبقًا وتخزينها مؤقتًا محليًا في: `~/.cache/huggingface/hub`. هذا هو دليل ذاكرة التخزين المؤقت الافتراضية المقدمة بواسطة متغير البيئة `TRANSFORMERS_CACHE`. على Windows، يكون دليل ذاكرة التخزين المؤقت الافتراضي هو `C:\Users\username\.cache\huggingface\hub`. يمكنك تغيير متغيرات البيئة أدناه - حسب الأولوية - لتحديد دليل ذاكرة التخزين المؤقت المختلفة: + +1. متغير البيئة (افتراضي): `HUGGINGFACE_HUB_CACHE` أو `TRANSFORMERS_CACHE`. +2. متغير البيئة: `HF_HOME`. +3. متغير البيئة: `XDG_CACHE_HOME` + `/huggingface`. + + + +سيستخدم 🤗 Transformers متغيرات البيئة `PYTORCH_TRANSFORMERS_CACHE` أو `PYTORCH_PRETRAINED_BERT_CACHE` إذا كنت قادمًا من إصدار سابق من هذه المكتبة وقمت بتعيين متغيرات البيئة هذه، ما لم تحدد متغير البيئة `TRANSFORMERS_CACHE`. + + + +## الوضع غير المتصل + +قم بتشغيل 🤗 Transformers في بيئة محمية بجدار حماية أو غير متصلة باستخدام الملفات المخزنة مؤقتًا محليًا عن طريق تعيين متغير البيئة `HF_HUB_OFFLINE=1`. + + + +أضف [🤗 Datasets](https://huggingface.co/docs/datasets/) إلى سير عمل التدريب غير المتصل باستخدام متغير البيئة `HF_DATASETS_OFFLINE=1`. + + + +```bash +HF_DATASETS_OFFLINE=1 HF_HUB_OFFLINE=1 \ +python examples/pytorch/translation/run_translation.py --model_name_or_path google-t5/t5-small --dataset_name wmt16 --dataset_config ro-en ... +``` + +يجب أن يعمل هذا البرنامج النصي دون تعليق أو انتظار انتهاء المهلة لأنه لن يحاول تنزيل النموذج من Hub. + +يمكنك أيضًا تجاوز تحميل نموذج من Hub من كل مكالمة [`~PreTrainedModel.from_pretrained`] باستخدام معلمة [`local_files_only`]. عندما يتم تعيينه على `True`، يتم تحميل الملفات المحلية فقط: + +```py +from transformers import T5Model + +model = T5Model.from_pretrained("./path/to/local/directory", local_files_only=True) +``` + +### الحصول على النماذج ومعالجات التوكينز لاستخدامها دون اتصال + +خيار آخر لاستخدام 🤗 Transformers دون اتصال هو تنزيل الملفات مسبقًا، ثم الإشارة إلى مسارها المحلي عند الحاجة إلى استخدامها دون اتصال. هناك ثلاث طرق للقيام بذلك: + +* قم بتنزيل ملف عبر واجهة المستخدم على [Model Hub](https://huggingface.co/models) بالنقر فوق أيقونة ↓. + + ![download-icon](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/download-icon.png) + +* استخدم سير عمل [`PreTrainedModel.from_pretrained`] و [`PreTrainedModel.save_pretrained`]: + + 1. قم بتنزيل ملفاتك مسبقًا باستخدام [`PreTrainedModel.from_pretrained`]: +* استخدم سير عمل [`PreTrainedModel.from_pretrained`] و [`PreTrainedModel.save_pretrained`]: + + 1. قم بتنزيل ملفاتك مسبقًا باستخدام [`PreTrainedModel.from_pretrained`]: + + ```py + >>> from transformers import AutoTokenizer, AutoModelForSeq2SeqLM + + >>> tokenizer = AutoTokenizer.from_pretrained("bigscience/T0_3B") + >>> model = AutoModelForSeq2SeqLM.from_pretrained("bigscience/T0_3B") + ``` + + 2. احفظ ملفاتك إلى دليل محدد باستخدام [`PreTrainedModel.save_pretrained`]: + + ```py + >>> tokenizer.save_pretrained("./your/path/bigscience_t0") + >>> model.save_pretrained("./your/path/bigscience_t0") + ``` + + 3. الآن عندما تكون غير متصل بالإنترنت، أعد تحميل ملفاتك باستخدام [`PreTrainedModel.from_pretrained`] من الدليل المحدد: + + ```py + >>> tokenizer = AutoTokenizer.from_pretrained("./your/path/bigscience_t0") + >>> model = AutoModel.from_pretrained("./your/path/bigscience_t0") + ``` + +* قم بتنزيل الملفات برمجيًا باستخدام مكتبة [huggingface_hub](https://github.com/huggingface/huggingface_hub/tree/main/src/huggingface_hub): + + 1. قم بتثبيت مكتبة `huggingface_hub` في بيئتك الافتراضية: + + ```bash + python -m pip install huggingface_hub + ``` + + 2. استخدم وظيفة [`hf_hub_download`](https://huggingface.co/docs/hub/adding-a-library#download-files-from-the-hub) لتنزيل ملف إلى مسار محدد. على سبيل المثال، يقوم الأمر التالي بتنزيل ملف `config.json` من نموذج [T0](https://huggingface.co/bigscience/T0_3B) إلى المسار المطلوب: + + ```py + >>> from huggingface_hub import hf_hub_download + + >>> hf_hub_download(repo_id="bigscience/T0_3B", filename="config.json", cache_dir="./your/path/bigscience_t0") + ``` + +بمجرد تنزيل ملفك وتخزينه مؤقتًا محليًا، حدد مساره المحلي لتحميله واستخدامه: + +```py +>>> from transformers import AutoConfig + +>>> config = AutoConfig.from_pretrained("./your/path/bigscience_t0/config.json") +``` + + + +راجع قسم [كيفية تنزيل الملفات من Hub](https://huggingface.co/docs/hub/how-to-downstream) لمزيد من التفاصيل حول تنزيل الملفات المخزنة على Hub. + + \ No newline at end of file From 9e8c3c7efa835e2cedd4efafc60aa673e62f0339 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:20:29 +0300 Subject: [PATCH 02/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 855308f733ea..4fa581cf2454 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -1,6 +1,6 @@ ## التثبيت -قم بتثبيت مكتبة 🤗 Transformers لمكتبة التعلم العميق التي تعمل معها، وقم بإعداد ذاكرة التخزين المؤقت الخاصة بك، وقم بإعداد 🤗 Transformers للعمل دون اتصال (اختياري). +قم بتثبيت مكتبة 🤗 Transformers المناسبة لمكتبة التعلم العميق التي تستخدمها، وقم بإعداد ذاكرة التخزين المؤقت الخاصة بك، وقم بإعداد 🤗 Transformers للعمل دون اتصال بالإنترنت (اختياري). تم اختبار 🤗 Transformers على Python 3.6+، وPyTorch 1.1.0+، وTensorFlow 2.0+، وFlax. اتبع تعليمات التثبيت أدناه لمكتبة التعلم العميق التي تستخدمها: From 537467681347646c0a0c23f7a9cafd39a08150e2 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:20:41 +0300 Subject: [PATCH 03/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 4fa581cf2454..e94f8a6595de 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -10,7 +10,7 @@ ## التثبيت باستخدام pip -يجب عليك تثبيت 🤗 Transformers في [بيئة افتراضية](https://docs.python.org/3/library/venv.html). إذا لم تكن معتادًا على البيئات الافتراضية في Python، فراجع هذا [الدليل](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/). تجعل البيئة الافتراضية من السهل إدارة المشاريع المختلفة، وتجنب مشكلات التوافق بين التبعيات. +يجب عليك تثبيت 🤗 Transformers داخل [بيئة افتراضية](https://docs.python.org/3/library/venv.html). إذا لم تكن غير ملم ببيئات Python الافتراضية، فراجع هذا [الدليل](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/). البيئة الافتراضية تسهل إدارة المشاريع المختلف، وتجنب مشكلات التوافق بين المكتبات المطلوبة (اعتماديات المشروع). ابدأ بإنشاء بيئة افتراضية في دليل مشروعك: From 44b18abb24dd98f51763223b759951374464606e Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:20:52 +0300 Subject: [PATCH 04/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index e94f8a6595de..f3cbe89d7445 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -24,7 +24,7 @@ python -m venv .env source .env/bin/activate ``` -قم بتنشيط البيئة الافتراضية على Windows: +قم بتفعيل البيئة الافتراضية على Windows: ```bash .env/Scripts/activate From b8e8cd5c3912c5eeb79ec11de69238d333239cfc Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:21:03 +0300 Subject: [PATCH 05/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index f3cbe89d7445..692439691f0a 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -18,7 +18,7 @@ python -m venv .env ``` -قم بتنشيط البيئة الافتراضية. على Linux وMacOs: +قم بتفعيل البيئة الافتراضية. على Linux وMacOs: ```bash source .env/bin/activate From e65685ba25cb8392aafe46915d446e6a02a5eec4 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:21:12 +0300 Subject: [PATCH 06/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 692439691f0a..75f393746ab9 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -154,7 +154,7 @@ conda install conda-forge::transformers -## الوضع غير المتصل +## الوضع دون اتصال بالإنترنت قم بتشغيل 🤗 Transformers في بيئة محمية بجدار حماية أو غير متصلة باستخدام الملفات المخزنة مؤقتًا محليًا عن طريق تعيين متغير البيئة `HF_HUB_OFFLINE=1`. From 4ee015971d941279cb6c0bb8930fbebbfb414291 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:21:23 +0300 Subject: [PATCH 07/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 75f393746ab9..03dd8438f2a6 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -169,7 +169,7 @@ HF_DATASETS_OFFLINE=1 HF_HUB_OFFLINE=1 \ python examples/pytorch/translation/run_translation.py --model_name_or_path google-t5/t5-small --dataset_name wmt16 --dataset_config ro-en ... ``` -يجب أن يعمل هذا البرنامج النصي دون تعليق أو انتظار انتهاء المهلة لأنه لن يحاول تنزيل النموذج من Hub. +يجب أن يعمل هذا البرنامج النصي دون توقف أو انتظار انتهاء المهلة الزمنية لأنه لن يحاول تنزيل النموذج من Hub. يمكنك أيضًا تجاوز تحميل نموذج من Hub من كل مكالمة [`~PreTrainedModel.from_pretrained`] باستخدام معلمة [`local_files_only`]. عندما يتم تعيينه على `True`، يتم تحميل الملفات المحلية فقط: From aec6fb48c7ad98127932e44491d5ef62e4a971ff Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:21:33 +0300 Subject: [PATCH 08/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 03dd8438f2a6..a08c55d09475 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -179,7 +179,7 @@ from transformers import T5Model model = T5Model.from_pretrained("./path/to/local/directory", local_files_only=True) ``` -### الحصول على النماذج ومعالجات التوكينز لاستخدامها دون اتصال +### جلب النماذج والمُجزّئات لاستخدامها دون اتصال بالإنترنت خيار آخر لاستخدام 🤗 Transformers دون اتصال هو تنزيل الملفات مسبقًا، ثم الإشارة إلى مسارها المحلي عند الحاجة إلى استخدامها دون اتصال. هناك ثلاث طرق للقيام بذلك: From ea325235d49487eb980465823e3296ec7abcc753 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:21:40 +0300 Subject: [PATCH 09/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index a08c55d09475..4c9bee4078c4 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -231,7 +231,7 @@ model = T5Model.from_pretrained("./path/to/local/directory", local_files_only=Tr >>> hf_hub_download(repo_id="bigscience/T0_3B", filename="config.json", cache_dir="./your/path/bigscience_t0") ``` -بمجرد تنزيل ملفك وتخزينه مؤقتًا محليًا، حدد مساره المحلي لتحميله واستخدامه: +بمجرد تنزيل ملفك وتخزينه مؤقتًا محليًا، حدد مساره المحلي الخاص به لتحميله واستخدامه: ```py >>> from transformers import AutoConfig From f7fa9f4d94c56e406bb988b077411793ba0e3407 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:23:25 +0300 Subject: [PATCH 10/17] Update installation.md --- docs/source/ar/installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 4c9bee4078c4..71ed1fdcdb23 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -1,4 +1,4 @@ -## التثبيت +# التثبيت (Installation) قم بتثبيت مكتبة 🤗 Transformers المناسبة لمكتبة التعلم العميق التي تستخدمها، وقم بإعداد ذاكرة التخزين المؤقت الخاصة بك، وقم بإعداد 🤗 Transformers للعمل دون اتصال بالإنترنت (اختياري). @@ -243,4 +243,4 @@ model = T5Model.from_pretrained("./path/to/local/directory", local_files_only=Tr راجع قسم [كيفية تنزيل الملفات من Hub](https://huggingface.co/docs/hub/how-to-downstream) لمزيد من التفاصيل حول تنزيل الملفات المخزنة على Hub. - \ No newline at end of file + From 6216c9ac1e5141afdabaf9994675a770724aa18a Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:24:36 +0300 Subject: [PATCH 11/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 71ed1fdcdb23..a6763be2ee99 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -2,7 +2,7 @@ قم بتثبيت مكتبة 🤗 Transformers المناسبة لمكتبة التعلم العميق التي تستخدمها، وقم بإعداد ذاكرة التخزين المؤقت الخاصة بك، وقم بإعداد 🤗 Transformers للعمل دون اتصال بالإنترنت (اختياري). -تم اختبار 🤗 Transformers على Python 3.6+، وPyTorch 1.1.0+، وTensorFlow 2.0+، وFlax. اتبع تعليمات التثبيت أدناه لمكتبة التعلم العميق التي تستخدمها: +تم اختبار 🤗 Transformers على Python 3.6 والإصدارات الأحدث، وPyTorch 1.1.0 والإصدارات الأحدث، وTensorFlow 2.0 والإصدارات الأحدث، وFlax. اتبع تعليمات التثبيت أدناه لمكتبة التعلم العميق التي تستخدمها: * تعليمات تثبيت [PyTorch](https://pytorch.org/get-started/locally/). * تعليمات تثبيت [TensorFlow 2.0](https://www.tensorflow.org/install/pip). From 1ec7cf968f2c51286e89c90854bdf6d30e8ac893 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:24:47 +0300 Subject: [PATCH 12/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index a6763be2ee99..d82554cb727e 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -171,7 +171,7 @@ python examples/pytorch/translation/run_translation.py --model_name_or_path goog يجب أن يعمل هذا البرنامج النصي دون توقف أو انتظار انتهاء المهلة الزمنية لأنه لن يحاول تنزيل النموذج من Hub. -يمكنك أيضًا تجاوز تحميل نموذج من Hub من كل مكالمة [`~PreTrainedModel.from_pretrained`] باستخدام معلمة [`local_files_only`]. عندما يتم تعيينه على `True`، يتم تحميل الملفات المحلية فقط: +يمكنك أيضًا تجاوز تحميل نموذج من Hub من كل استدعاء [`~PreTrainedModel.from_pretrained`] باستخدام معلمة [`local_files_only`]. عندما يتم تعيينها على `True`، يتم تحميل الملفات المحلية فقط: ```py from transformers import T5Model From 45c87fb41a0412b0fcf771ac2d8301d924fe0864 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:25:07 +0300 Subject: [PATCH 13/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index d82554cb727e..b0cb12482f75 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -86,7 +86,7 @@ python -c "from transformers import pipeline; print(pipeline('sentiment-analysis pip install git+https://github.com/huggingface/transformers ``` -يقوم هذا الأمر بتثبيت إصدار `main` النازف بدلاً من الإصدار `stable` الأحدث. يعد إصدار `main` مفيدًا للبقاء على اطلاع دائم بأحدث التطورات. على سبيل المثال، إذا تم إصلاح خطأ منذ الإصدار الرسمي الأخير ولكن لم يتم طرح إصدار جديد بعد. ومع ذلك، فإن هذا يعني أن إصدار `main` قد لا يكون مستقرًا دائمًا. نسعى جاهدين للحفاظ على تشغيل إصدار `main`، ويتم حل معظم المشكلات عادةً في غضون بضع ساعات أو يوم. إذا واجهتك مشكلة، يرجى فتح [قضية](https://github.com/huggingface/transformers/issues) حتى نتمكن من إصلاحها في أقرب وقت ممكن! +يقوم هذا الأمر بتثبيت أحدث إصدار تجريبي `main` بدلاً من الإصدار المستقر `stable`. يعد إصدار `main` مفيدًا للمواكبة مع أحدث التطورات. على سبيل المثال، إذا تم إصلاح خطأ منذ الإصدار الرسمي الأخير ولكن لم يتم طرح إصدار جديد بعد. ومع ذلك، فإن هذا يعني أن إصدار التجريبي `main` قد لا يكون مستقرًا دائمًا. نسعى جاهدين للحفاظ على تشغيل إصدار `main`، ويتم حل معظم المشكلات عادةً في غضون بضع ساعات أو يوم. إذا واجهتك مشكلة، يرجى فتح [تقرير عن خلل](https://github.com/huggingface/transformers/issues) حتى نتمكن من إصلاحها في أقرب وقت ممكن! تحقق مما إذا كان 🤗 Transformers قد تم تثبيته بشكل صحيح عن طريق تشغيل الأمر التالي: From bfb38bba61b68b473ac67bd977196c7ace5878bf Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:25:23 +0300 Subject: [PATCH 14/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index b0cb12482f75..bdb8a901e5f3 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -100,7 +100,7 @@ python -c "from transformers import pipeline; print(pipeline('sentiment-analysis python -c "from transformers import pipeline; print(pipeline('sentiment-analysis')('I love you'))" ``` -## التثبيت القابل للتحرير +## التثبيت القابل للتعديل ستحتاج إلى تثبيت قابل للتحرير إذا كنت ترغب في: From acba7c3b67f717a2bf572a7ab040df40c114b84b Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:25:37 +0300 Subject: [PATCH 15/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index bdb8a901e5f3..864e3455abbb 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -102,7 +102,7 @@ python -c "from transformers import pipeline; print(pipeline('sentiment-analysis ## التثبيت القابل للتعديل -ستحتاج إلى تثبيت قابل للتحرير إذا كنت ترغب في: +ستحتاج إلى تثبيت قابل للتعديل إذا كنت ترغب في: * استخدام إصدار `main` من كود المصدر. * المساهمة في 🤗 Transformers وتحتاج إلى اختبار التغييرات في الكود. From d14873d609802ec14e0624e13f804145e90a24cb Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:25:54 +0300 Subject: [PATCH 16/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index 864e3455abbb..dcbd570f81a8 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -115,7 +115,7 @@ cd transformers pip install -e . ``` -سترتبط هذه الأوامر مجلد المستودع الذي قمت باستنساخه ومسارات مكتبة Python. الآن، سيبحث Python داخل المجلد الذي قمت باستنساخه بالإضافة إلى مسارات المكتبة العادية. على سبيل المثال، إذا تم تثبيت حزم Python الخاصة بك عادةً في `~/anaconda3/envs/main/lib/python3.7/site-packages/`, فسيقوم Python أيضًا بالبحث في المجلد الذي قمت باستنساخه: `~/transformers/`. + ستقوم هذه الأوامر بربط المجلد الذي قمت باستنساخ المستودع فيه بمسارات مكتبة Python. بمعنى آخر، سيبحث Python داخل المجلد الذي قمت باستنساخه بالإضافة إلى المسارات المعتادة للمكتبات. على سبيل المثال، إذا تم تثبيت حزم Python الخاصة بك عادةً في `~/anaconda3/envs/main/lib/python3.7/site-packages/`, فسيقوم Python أيضًا بالبحث في المجلد الذي قمت باستنساخه: `~/transformers/`. From f3f9f6327159e29cf2af99d01ba2cc4a949bdd31 Mon Sep 17 00:00:00 2001 From: Ahmed Almaghz <53489256+AhmedAlmaghz@users.noreply.github.com> Date: Fri, 30 Aug 2024 20:26:11 +0300 Subject: [PATCH 17/17] Update docs/source/ar/installation.md Co-authored-by: Abdullah Mohammed <554032+abodacs@users.noreply.github.com> --- docs/source/ar/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/ar/installation.md b/docs/source/ar/installation.md index dcbd570f81a8..ac5962ec8589 100644 --- a/docs/source/ar/installation.md +++ b/docs/source/ar/installation.md @@ -142,7 +142,7 @@ conda install conda-forge::transformers ## إعداد ذاكرة التخزين المؤقت -يتم تنزيل النماذج المدربة مسبقًا وتخزينها مؤقتًا محليًا في: `~/.cache/huggingface/hub`. هذا هو دليل ذاكرة التخزين المؤقت الافتراضية المقدمة بواسطة متغير البيئة `TRANSFORMERS_CACHE`. على Windows، يكون دليل ذاكرة التخزين المؤقت الافتراضي هو `C:\Users\username\.cache\huggingface\hub`. يمكنك تغيير متغيرات البيئة أدناه - حسب الأولوية - لتحديد دليل ذاكرة التخزين المؤقت المختلفة: +تُحمّل النماذج المُسبقة التدريب وتُخزّن مؤقتًا في: `~/.cache/huggingface/hub`. هذا هو المجلد الافتراضي الذي يُحدده متغير البيئة `TRANSFORMERS_CACHE`. على Windows، يكون دليل ذاكرة التخزين المؤقت الافتراضي هو `C:\Users\username\.cache\huggingface\hub`. يمكنك تغيير متغيرات البيئة shell الموضحة أدناه - حسب الأولوية - لتحديد دليل ذاكرة تخزين مؤقت مختلف: 1. متغير البيئة (افتراضي): `HUGGINGFACE_HUB_CACHE` أو `TRANSFORMERS_CACHE`. 2. متغير البيئة: `HF_HOME`.