Guide de lecture localisé
hf-cloud-python-env-setupObjectif, utilisation et source
Configurez un environnement Python isolé pour le travail avec SageMaker/AWS, avec la version Python appropriée et la version boto actuelle.3Utilisez cette compétence chaque fois que du code Python est exécuté pour un déploiement SageMaker, une tâche de formation ou toute automatisation AWS, y compris avant l'exécution.pip install, au moment d'invoquerboto3, lors de la création ou de l'activation d'un environnement virtuel, ou lorsque l'utilisateur demande à « configurer l'environnement ». N'utilisez jamais la version système de Python et jamaispip installIntégrez-y le code. Isolez-le systématiquement. Cette compétence permet d'éviter les pannes les plus fréquentes : version Python incorrecte, conflits de dépendances et kits de développement logiciel obsolètes.
Source récupérée:
- Dépôt source
- huggingface/skills
- SKILL.md
skills/hf-cloud-python-env-setup/SKILL.md- Étoiles du dépôt
- 11,241
- Mise à jour du dépôt
- 2026-10-30
- Catégories de capacités
- Services cloud
- Dernière collecte
Licence : Apache-2.0
Les extraits de flux de travail sont des outils de lecture et non des instructions exécutables de Codez. Aucune compétence tierce n'a été utilisée pour générer cette page.
Les passages relatifs à l'objectif et au flux de travail ci-dessous constituent le contenu original, organisé et traduit pour la lecture. Ils sont distincts de l'analyse éditoriale de Codez, qui est étiquetée séparément.
À quoi sert cette compétence ?
Configurez un environnement Python isolé pour le travail avec SageMaker/AWS, avec la version Python appropriée et la version boto actuelle.3Utilisez cette compétence chaque fois que du code Python est exécuté pour un déploiement SageMaker, une tâche de formation ou toute automatisation AWS, y compris avant l'exécution.pip install, au moment d'invoquerboto3, lors de la création ou de l'activation d'un environnement virtuel, ou lorsque l'utilisateur demande à « configurer l'environnement ». N'utilisez jamais la version système de Python et jamaispip installIntégrez-y le code. Isolez-le systématiquement. Cette compétence permet d'éviter les pannes les plus fréquentes : version Python incorrecte, conflits de dépendances et kits de développement logiciel obsolètes.
Comment fonctionne le flux de travail en amont
Comment configurer
La méthode la plus rapide consiste à utiliser le script intégré — étant écrit en Python, il fonctionne de la même manière sous Windows, macOS et Linux : ce script détecteuvet l'utilise si disponible (plus rapide), sinon elle utilise la bibliothèque standard.venvmodule, crée.venv/avec Python3.12(outrepasser:python3 setup_env.py .venv 3.11), refuse les versions Python non prises en charge, installe à partir du package intégrérequirements.txtet est idempotent. Il affiche également le chemin d'accès correct à l'interpréteur pour le système d'exploitation hôte (voir ci-dessous). Après la configuration, invoquez explicitement Python dans l'environnement plutôt que d'activer l'environnement virtuel. Le chemin d'accès à l'interpréteur diffère selon la plateforme : cela fonctionne de la même manière dans les scripts, les shells interactifs et les appels d'outils d'agent. Le reste de cette compétence écrit.venv/bin/pythonPar souci de concision, sous Windows, on utilise un substitut..venv\Scripts\python.exe.
boto3par rapport au SDK SageMaker
Deux cas spécifiques de SDK qui nécessitent encore une attention particulière :
passage en amont · L18 ↗python3 scripts/setup_env.py # macOS / Linux
python scripts/setup_env.py # Windows (PowerShell / cmd)Configuration requise
Configuration de l'environnement Python pour SageMaker
La plupart des échecs de déploiement de SageMaker qui semblent liés à AWS sont en réalité dus à des problèmes d'environnement Python : version de Python incorrecte, résolution de dépendances défectueuse, SDK obsolète ne prenant pas en charge une API récente. Cette compétence rend la configuration de l'environnement simple et correcte.
passage en amont · L6 ↗Limites et contrôles de qualité
Pièges courants
Mystérieuxpip installErreurs de résolution Presque toujours Python3.13+ Tentative d'installation de paquets sans roues, ou installation dans un système Python pollué. Recréer à3.12: supprimer.venvet relancerpython3 setup_env.py .venv 3.12(Le script recrée l'environnement lorsque la version ne correspond pas, vous pouvez donc également simplement le réexécuter).pip installL'opération a réussi, mais le script indique « module introuvable ». Vous l'avez installé dans un interpréteur différent de celui qui exécute le script. Appelez toujours Python explicitement..venv/bin/python -m pip install ...et.venv/bin/python deploy.py.
Règles fondamentales
N’utilisez jamais la version Python du système. Travaillez toujours dans un environnement isolé. Spécifiez la version de Python, et non celle des paquets.3.10,3.11, ou3.12. Éviter3.13Les bibliothèques ML présentent des retards dans la disponibilité des roues et des problèmes de résolution de dépendances parfois déroutants. Installez la dernière version de chaque paquet. Évitez de figer les versions par précaution.boto3ouawscliLes versions plus récentes disposent d'API à jour et de correctifs de sécurité. N'imposez une version spécifique que si l'utilisateur l'exige explicitement. Vérifiez correctement les versions installées.importlib.metadata.version("package-name"), jamaismodule.__version__Ce dernier point est incohérent d'un package à l'autre.
Commencez par un essai sans danger
- Vérifiez l'hôte pris en charge et les instructions d'installation du dépôt. Conservez le répertoire Skill ainsi que ses scripts, ressources et documentation référencés ;SKILL.mdSeul, il peut omettre les dépendances.
- Indiquez à l'agent vos paramètres d'entrée réels, le résultat souhaité et les critères d'acceptation. La syntaxe d'appel et les outils disponibles dépendent du système hôte ; ce site ne propose pas de commande d'installation universelle.
- Testez le flux de travail source dans un projet temporaire ou sur une copie. Avant d'autoriser les opérations qui modifient des fichiers, des services distants ou des ressources facturables, examinez-les attentivement.
- Vérifiez la conformité du résultat avec les contrôles qualité sources et vos propres exigences. Un déclenchement réussi ou un nombre élevé d'étoiles dans le dépôt ne garantissent pas un résultat correct.
Pour en savoir plus, consultez la source.
Compétences connexes
Traduction et étendue
Ce guide de lecture sélectionne des passages de l'amont épingléSKILL.mdCette traduction est assistée. Elle ne constitue pas un manuel complet et ne garantit pas une compatibilité testée. Veuillez lire le document original et les fichiers auxquels il fait référence avant utilisation.
Cette introduction fait référence à la version épinglée ci-dessous ; l’activité actuelle du dépôt et la durée de la collecte sont indiquées séparément.
- Source épinglée
- Lire l'original ↗
- Source récupérée
- Commit source
fabc634a893f62ad5c2039830397efa35fa62715- Source SHA-256
c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8