Skill 多语言阅读指南
hf-cloud-python-env-setup用途、用法与原始来源
为 SageMaker / AWS 工作搭建一个独立的 Python 环境，并安装正确的 Python 版本和最新的 boto。3每当需要在 SageMaker 部署、训练作业或任何 AWS 自动化过程中执行 Python 代码时，包括即将运行时，都应使用此技能。pip install即将调用boto3创建或激活虚拟环境时，或者用户请求“设置环境”时，切勿使用系统 Python，也切勿pip install深入研究。始终进行隔离。这项技能可以避免最常见的故障模式：Python 版本错误、依赖冲突和过时的 SDK。
原文采集时间:
- SKILL.md
skills/hf-cloud-python-env-setup/SKILL.md- 仓库 Star
- 11,241
- 仓库最近更新
- 2026/10/30
- 能力分类
- 云服务
- 最近采集时间
许可：Apache-2.0
流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill，不属于实测评测。
下面的用途和操作片段来自上游文档，由本站整理并翻译，和另行标注的 Codez 编辑分析分开展示。
这个 Skill 能做什么
为 SageMaker / AWS 工作搭建一个独立的 Python 环境，并安装正确的 Python 版本和最新的 boto。3每当需要在 SageMaker 部署、训练作业或任何 AWS 自动化过程中执行 Python 代码时，包括即将运行时，都应使用此技能。pip install即将调用boto3创建或激活虚拟环境时，或者用户请求“设置环境”时，切勿使用系统 Python，也切勿pip install深入研究。始终进行隔离。这项技能可以避免最常见的故障模式：Python 版本错误、依赖冲突和过时的 SDK。
如何使用：上游操作流程
如何设置
最快的方法是使用捆绑的脚本——它是用 Python 编写的，因此在 Windows、macOS 和 Linux 上运行效果相同：该脚本可以检测……uv如果可用则使用（速度更快），否则回退到标准库。venv模块，创建.venv/使用 Python3.12（覆盖：python3 setup_env.py .venv 3.11拒绝不支持的 Python 版本，从捆绑包安装requirements.txt并且是幂等的。它还会打印出宿主操作系统的正确解释器路径（见下文）。设置完成后，请显式调用环境中的 Python，而不是激活虚拟环境。解释器路径因平台而异：这在脚本、交互式 shell 和代理工具调用中都适用。此技能的其余部分会写入.venv/bin/python为简洁起见——在 Windows 替代.venv\Scripts\python.exe。
python3 scripts/setup_env.py # macOS / Linux
python scripts/setup_env.py # Windows (PowerShell / cmd)环境与依赖
SageMaker 的 Python 环境配置
大多数看似AWS问题的SageMaker部署失败实际上是Python环境问题：Python版本错误、依赖项解析错误、过时的SDK无法识别最新的API。掌握这项技能可以让环境配置变得简单而正确。
原文片段 · L6 ↗限制与结果检查
常见陷阱
神秘pip install解析错误几乎总是 Python3.13+ 尝试安装尚未安装 wheel 包的软件包，或者安装到已污染的 Python 系统中。请重现此问题。3.12： 删除.venv并重新运行python3 setup_env.py .venv 3.12（当版本不匹配时，脚本会重新创建环境，因此您也可以直接重新运行它）。pip install安装成功，但脚本提示“找不到模块”。您安装的 Python 解释器与运行脚本的解释器不同。请始终显式调用 Python：.venv/bin/python -m pip install ...和.venv/bin/python deploy.py。
核心规则
永远不要使用系统自带的 Python。始终在隔离的环境中工作。锁定 Python 版本，而不是软件包版本。3.10，3.11， 或者3.12。 避免3.13+ — 机器学习库的 wheel 包可用性存在滞后，依赖关系解析也容易出现令人困惑的问题。请安装每个软件包的最新版本。不要过度依赖版本控制。boto3或者awscli新版本具备最新的 API 接口和安全修复。仅当用户明确要求特定版本时才锁定版本。请正确检查已安装的版本。importlib.metadata.version("package-name")， 绝不module.__version__后者在不同的软件包中并不一致。
开始使用前
- 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档，只复制 SKILL.md 可能漏掉依赖。
- 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境，本站不假定存在通用的安装命令。
- 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作，应逐项核对后再授权。
- 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高，都不能证明结果正确。
继续阅读原始文档
相关 Skill
翻译与介绍范围
本页从固定版本的上游 SKILL.md 整理用途与操作片段，译文使用辅助翻译。它不是完整手册，也不代表经过兼容性实测；使用前请核对原文及其引用文件。
介绍依据下方列出的固定版本；当前仓库动态和目录采集时间单独展示。
- 固定版本来源
- 阅读原文 ↗
- 原文采集时间
- 来源提交版本
fabc634a893f62ad5c2039830397efa35fa62715- 原文 SHA-256
c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8