Guía de lectura localizada
hf-cloud-python-env-setupFinalidad, uso y origen
Configure un entorno Python aislado para trabajar con SageMaker / AWS, con la versión correcta de Python y el boto actual.3Utilice esta habilidad siempre que se vaya a ejecutar código Python para una implementación de SageMaker, un trabajo de capacitación o cualquier automatización de AWS, incluso cuando esté a punto de ejecutarpip install, cuando está a punto de invocarboto3, al crear o activar un entorno virtual, o cuando el usuario solicita "configurar el entorno". Nunca utilice Python del sistema y nuncapip installEntra en ello. Siempre aísla. Esta habilidad previene los modos de fallo más comunes: versión incorrecta de Python, conflictos de dependencias y SDK obsoletos.
Fuente recuperada:
- Repositorio de origen
- huggingface/skills
- SKILL.md
skills/hf-cloud-python-env-setup/SKILL.md- Estrellas del repositorio
- 11,241
- Actualización del repositorio
- 2026-10-30
- Clasificación de habilidades
- Servicios en la nube
- Última recopilación
Licencia: Apache-2.0
Los extractos del flujo de trabajo son guías de lectura, no instrucciones ejecutables de Codez. No se utilizó ninguna habilidad de terceros para generar esta página.
Los siguientes fragmentos sobre el propósito y el flujo de trabajo son material preliminar, organizado y traducido para su lectura. Son distintos del análisis editorial de Codez, que se presenta por separado.
Lo que hace esta habilidad
Configure un entorno Python aislado para trabajar con SageMaker / AWS, con la versión correcta de Python y el boto actual.3Utilice esta habilidad siempre que se vaya a ejecutar código Python para una implementación de SageMaker, un trabajo de capacitación o cualquier automatización de AWS, incluso cuando esté a punto de ejecutarpip install, cuando está a punto de invocarboto3, al crear o activar un entorno virtual, o cuando el usuario solicita "configurar el entorno". Nunca utilice Python del sistema y nuncapip installEntra en ello. Siempre aísla. Esta habilidad previene los modos de fallo más comunes: versión incorrecta de Python, conflictos de dependencias y SDK obsoletos.
Cómo funciona el flujo de trabajo ascendente
Cómo configurar
La ruta más rápida es el script incluido; es Python, por lo que se ejecuta igual en Windows, macOS y Linux: Este script detectauvy lo usa si está disponible (más rápido), si no, recurre a la biblioteca estándar.venvmódulo, crea.venv/con Python3.12(anular:python3 setup_env.py .venv 3.11), rechaza versiones de Python no compatibles, instala desde el paqueterequirements.txty es idempotente. También imprime la ruta correcta del intérprete para el sistema operativo anfitrión (ver más abajo). Después de la configuración, invoque el Python del entorno explícitamente en lugar de activar el venv. La ruta del intérprete difiere según la plataforma: Esto funciona igual en scripts, shells interactivos y llamadas a herramientas de agente. El resto de esta habilidad escribe.venv/bin/pythonpara brevedad — en Windows sustituir.venv\Scripts\python.exe.
boto3frente al SDK de SageMaker
Dos casos específicos del SDK que aún requieren atención:
Paso río arriba · L18 ↗python3 scripts/setup_env.py # macOS / Linux
python scripts/setup_env.py # Windows (PowerShell / cmd)Requisitos y configuración
Configuración del entorno Python para SageMaker
La mayoría de los fallos de implementación de SageMaker que parecen problemas de AWS son en realidad problemas del entorno de Python: versión incorrecta de Python, resolución de dependencias defectuosa, SDK obsoleto que no reconoce la API actual. Esta habilidad hace que la configuración del entorno sea sencilla y correcta.
Paso río arriba · L6 ↗Límites y controles de calidad
errores comunes
Misteriosopip installerrores de resolución Casi siempre Python3.13+ intentando instalar paquetes sin wheel todavía, o instalando en un sistema Python contaminado. Recrear en3.12: borrar.venvy volver a ejecutarpython3 setup_env.py .venv 3.12(El script recrea el entorno cuando la versión no coincide, por lo que también puedes simplemente volver a ejecutarlo).pip installLa operación se realizó correctamente, pero el script indica "módulo no encontrado". Lo instalaste en un intérprete diferente al que ejecuta el script. Siempre invoca Python explícitamente..venv/bin/python -m pip install ...y.venv/bin/python deploy.py.
Reglas básicas
Nunca utilice el Python del sistema. Trabaje siempre dentro de un entorno aislado. Fije la versión de Python, no las versiones de los paquetes. Utilice3.10,3.11, o3.12. Evitar3.13+ — Las bibliotecas de ML se retrasan en la disponibilidad de wheel y la resolución de dependencias se rompe de maneras confusas. Instale la última versión de cada paquete. No fije defensivamenteboto3oawscliLas versiones más recientes tienen interfaces API actualizadas y correcciones de seguridad. Solo fije una versión si el usuario requiere explícitamente una versión específica. Verifique correctamente las versiones instaladas. Utiliceimportlib.metadata.version("package-name"), nuncamodule.__version__Esto último es inconsistente entre los distintos paquetes.
Comience con una prueba segura.
- Verifique el host compatible y las instrucciones de instalación del repositorio. Mantenga juntos el directorio Skill y sus scripts, recursos y documentación a los que hace referencia;SKILL.mdsolo puede omitir dependencias.
- Proporcione al agente sus datos reales, el resultado deseado y los criterios de aceptación. La sintaxis de invocación y las herramientas disponibles dependen del sistema anfitrión; este sitio no presupone un comando de instalación universal.
- Pruebe el flujo de trabajo original en un proyecto desechable o en una copia. Revise las operaciones que modifican archivos, servicios remotos o recursos facturables antes de autorizarlas.
- Valide el resultado comparándolo con los controles de calidad de origen y sus propios requisitos. Un activador exitoso o un alto número de estrellas en el repositorio no garantizan un resultado correcto.
Lea más en la fuente
Habilidades relacionadas
Traducción y alcance
Esta guía de lectura selecciona pasajes de la sección fijada en la parte superior.SKILL.mdLa traducción es asistida. No se trata de un manual completo ni garantiza la compatibilidad. Lea el original y los archivos a los que hace referencia antes de usarlo.
Esta introducción hace referencia a la versión fijada a continuación; la actividad actual del repositorio y la hora de recopilación se muestran por separado.
- Fuente fijada
- Lee el original ↗
- Fuente recuperada
- Confirmación de origen
fabc634a893f62ad5c2039830397efa35fa62715- Fuente SHA-256
c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8