دليل قراءة متعدد اللغات للمهارة
hf-cloud-python-env-setupالغرض والاستخدام والمصدر
قم بإعداد بيئة بايثون معزولة للعمل مع SageMaker / AWS، باستخدام إصدار بايثون الصحيح و boto الحالي3استخدم هذه المهارة كلما تم تنفيذ كود بايثون لنشر SageMaker أو مهمة تدريب أو أي عملية أتمتة AWS - بما في ذلك عند بدء التشغيلpip install، عندما يكون على وشك الاستدعاءboto3عند إنشاء بيئة افتراضية أو تفعيلها، أو عندما يطلب المستخدم "إعداد البيئة". لا تستخدم أبدًا بايثون النظام، ولا تستخدم أبدًاpip installاحرص دائمًا على عزل المشكلة. هذه المهارة تمنع أكثر أسباب الفشل شيوعًا: إصدار بايثون غير الصحيح، وتعارضات التبعيات، ومجموعات تطوير البرامج القديمة.
تم استرجاع المصدر:
- مستودع المصدر
- huggingface/skills
- SKILL.md
skills/hf-cloud-python-env-setup/SKILL.md- نجوم المستودع
- 11,241
- آخر تحديث للمستودع
- 2026-10-30
- تصنيف القدرات
- خدمات الحوسبة السحابية
- وقت التجميع الأخير
الترخيص: Apache-2.0
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
قم بإعداد بيئة بايثون معزولة للعمل مع SageMaker / AWS، باستخدام إصدار بايثون الصحيح و boto الحالي3استخدم هذه المهارة كلما تم تنفيذ كود بايثون لنشر SageMaker أو مهمة تدريب أو أي عملية أتمتة AWS - بما في ذلك عند بدء التشغيلpip install، عندما يكون على وشك الاستدعاءboto3عند إنشاء بيئة افتراضية أو تفعيلها، أو عندما يطلب المستخدم "إعداد البيئة". لا تستخدم أبدًا بايثون النظام، ولا تستخدم أبدًاpip installاحرص دائمًا على عزل المشكلة. هذه المهارة تمنع أكثر أسباب الفشل شيوعًا: إصدار بايثون غير الصحيح، وتعارضات التبعيات، ومجموعات تطوير البرامج القديمة.
طريقة الاستخدام وفق المستند الأصلي
كيفية الإعداد
أسرع طريقة هي استخدام البرنامج النصي المرفق - فهو مكتوب بلغة بايثون، لذا فهو يعمل بنفس الطريقة على أنظمة ويندوز وماك أو إس ولينكس: هذا البرنامج النصي يكتشفuvويستخدمها إذا كانت متاحة (أسرع)، أو يعود إلى المكتبة القياسية (stdlib) في حال عدم توفرها.venvوحدة، تقوم بإنشاء.venv/باستخدام لغة بايثون3.12(تجاوز:python3 setup_env.py .venv 3.11يرفض إصدارات بايثون غير المدعومة، ويقوم بالتثبيت من الحزمة المرفقة.requirements.txtوهو برنامج متكرر لا يتغير. كما أنه يطبع مسار المفسر الصحيح لنظام التشغيل المضيف (انظر أدناه). بعد الإعداد، استدعِ بايثون الخاص بالبيئة الافتراضية صراحةً بدلاً من تفعيل البيئة الافتراضية. يختلف مسار المفسر باختلاف النظام الأساسي: يعمل هذا بنفس الطريقة في البرامج النصية، والأصداف التفاعلية، واستدعاءات أدوات الوكيل. يكتب باقي هذا البرنامج.venv/bin/pythonللاختصار — بديل على نظام ويندوز.venv\Scripts\python.exe.
بوتو3مقابل SageMaker SDK
حالتان محددتان من حالات SDK لا تزالان بحاجة إلى معالجة:
مقتطف من المصدر · L18 ↗python3 scripts/setup_env.py # macOS / Linux
python scripts/setup_env.py # Windows (PowerShell / cmd)المتطلبات والإعداد
إعداد بيئة بايثون لـ SageMaker
معظم حالات فشل نشر SageMaker التي تبدو وكأنها مشاكل في AWS هي في الواقع مشاكل في بيئة Python: إصدار Python غير صحيح، أو خلل في حل التبعيات، أو استخدام SDK قديم لا يدعم واجهة برمجة التطبيقات الحالية. هذه المهارة تجعل إعداد البيئة أمرًا بسيطًا وصحيحًا.
مقتطف من المصدر · L6 ↗الحدود وفحوصات الجودة
الأخطاء الشائعة
غامضpip installأخطاء في الدقة، غالباً ما تحدث في بايثون3.13+ محاولة تثبيت حزم بدون ملفات التثبيت (wheels) بعد، أو التثبيت في نظام بايثون غير مستقر. أعد إنشاء المشكلة على3.12: يمسح.venvوأعد تشغيلهpython3 setup_env.py .venv 3.12(يقوم البرنامج النصي بإعادة إنشاء البيئة عندما لا تتطابق النسخة، لذلك يمكنك أيضًا إعادة تشغيله).pip installنجحت العملية، لكن البرنامج النصي يُظهر رسالة "لم يتم العثور على الوحدة". لقد قمتَ بالتثبيت في مُفسِّر مختلف عن المُفسِّر الذي يُشغِّل البرنامج النصي. استدعِ بايثون صراحةً دائمًا..venv/bin/python -m pip install ...و.venv/bin/python deploy.py.
القواعد الأساسية
لا تستخدم بايثون النظام أبدًا. اعمل دائمًا داخل بيئة معزولة. ثبّت إصدار بايثون، وليس إصدارات الحزم.3.10،3.11، أو3.12. يتجنب3.13+ — تعاني مكتبات التعلم الآلي من تأخر في توفر ملفات التثبيت، كما أن حل التبعيات يتعطل بطرق مُربكة. ثبّت أحدث إصدار من كل حزمة. لا تُثبّت الحزم بشكل احترازي.boto3أوawscliتتضمن الإصدارات الأحدث واجهات برمجة تطبيقات حديثة وتحديثات أمنية. لا تقم بتثبيت إصدار معين إلا إذا طلبه المستخدم صراحةً. تأكد من صحة الإصدارات المثبتة.importlib.metadata.version("package-name")، أبداًmodule.__version__وهذا الأخير غير متسق بين الحزم.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
fabc634a893f62ad5c2039830397efa35fa62715- المصدر SHA-256
c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8