ローカライズされた読書ガイド

hf-cloud-python-env-setup目的、用途、および情報源

SageMaker / AWS 作業用に、適切な Python バージョンと最新の boto を備えた隔離された Python 環境をセットアップします。3SageMaker のデプロイ、トレーニングジョブ、またはその他の AWS 自動化で Python コードが実行される場合、実行しようとしているときを含め、このスキルを使用してください。pip install呼び出そうとしているときboto3仮想環境を作成またはアクティブ化するとき、またはユーザーが「環境をセットアップする」ように要求したとき。システムの Python は決して使用せず、pip install必ず分離して使用してください。このスキルを身につけることで、Python のバージョン間違い、依存関係の競合、古い SDK など、最も一般的な障害を回避できます。

ソースを取得しました: 2026-10-29

出典リポジトリ: huggingface/skills
SKILL.md: skills/hf-cloud-python-env-setup/SKILL.md
リポジトリの Star: 11,241
リポジトリの最終更新: 2026-10-30
能力分類: クラウドサービス
最終収集時刻: 2026-10-31 10:38 UTC+08:00

ライセンス: Apache-2.0

オリジナルのSKILL.md

ワークフローの抜粋は、Codezによる実行可能な指示ではなく、あくまでも参考資料です。このページを作成するために、サードパーティ製のスキルは実行されていません。

以下の目的とワークフローに関する記述は、上流工程に関する資料であり、読みやすいように整理・翻訳されています。これらは、別途ラベル付けされたCodez編集分析とは区別されます。

このスキルが何をするか

上流ワークフローの仕組み

設定方法

最も速い方法は同梱のスクリプトを使用することです。これはPythonで書かれているため、Windows、macOS、Linuxで同じように動作します。このスクリプトは以下を検出します。uv利用可能であればそれを使用し（より高速）、利用できない場合は標準ライブラリにフォールバックする。venvモジュールを作成します.venv/Pythonで3.12（オーバーライド：python3 setup_env.py .venv 3.11サポートされていない Python バージョンを拒否し、バンドルされているものからインストールします。requirements.txt、冪等性があります。また、ホストOSの正しいインタプリタパスも出力します（下記参照）。セットアップ後、venvをアクティブ化するのではなく、環境のPythonを明示的に呼び出します。インタプリタパスはプラットフォームによって異なります。これは、スクリプト、対話型シェル、エージェントツール呼び出しで同じように機能します。このスキルの残りの部分は、.venv/bin/python簡潔にするため、Windows では次のように置き換えてください。.venv\Scripts\python.exe。

上流への航路 · L31 ↗

ボト3SageMaker SDKとの比較

まだ対応が必要なSDKの具体的なケースが2つあります。

上流への航路 · L18 ↗

上流への航路 · bash ↗

python3 scripts/setup_env.py        # macOS / Linux
python  scripts/setup_env.py        # Windows (PowerShell / cmd)

要件とセットアップ

SageMaker用のPython環境設定

AWSの問題のように見えるSageMakerのデプロイ失敗のほとんどは、実際にはPython環境の問題です。Pythonのバージョンが間違っている、依存関係の解決がうまくいっていない、最新のAPIに対応していない古いSDKを使用しているなどが原因です。このスキルを身につければ、環境設定が退屈ながらも正しく行えるようになります。

上流への航路 · L6 ↗

制限事項と品質チェック

よくある落とし穴

ミステリアスpip install解決エラーほとんどの場合Python3.13+ ホイールのないパッケージをインストールしようとしているか、または汚染されたシステムに Python をインストールしようとしています。3.12：消去.venvそして再実行python3 setup_env.py .venv 3.12（バージョンが一致しない場合はスクリプトが環境を再作成するので、単に再実行するだけでも構いません。）pip installスクリプトは成功しましたが、「モジュールが見つかりません」と表示されます。スクリプトを実行しているインタープリタとは異なるインタープリタにインストールしました。Python は常に明示的に呼び出してください。.venv/bin/python -m pip install ...そして.venv/bin/python deploy.py。

上流への航路 · L75 ↗

基本ルール

システムの Python は絶対に使用しないでください。常に隔離された環境内で作業してください。パッケージのバージョンではなく、Python のバージョンを固定してください。3.10、3.11、または3.12。避ける3.13+ — MLライブラリはwheelファイルの入手が遅れており、依存関係の解決が混乱を招く形で壊れています。各パッケージの最新版をインストールしてください。防御的に固定しないでください。boto3またはawscli. 新しいバージョンには最新の API サーフェスとセキュリティ修正が含まれています。ユーザーが特定のバージョンを明示的に要求する場合にのみピン留めしてください。インストールされているバージョンを正しく確認してください。importlib.metadata.version("package-name")、一度もないmodule.__version__後者はパッケージによって一貫性がない。

上流への航路 · L10 ↗

まずは安全なトライアルから始めましょう

サポートされているホストとリポジトリのインストール手順を確認してください。スキルディレクトリと、それに関連付けられているスクリプト、アセット、ドキュメントはまとめて保管してください。SKILL.md単独では依存関係を省略できる場合があります。
エージェントに実際の入力、希望する出力、および受け入れ基準を指定してください。呼び出し構文と利用可能なツールはホストによって異なります。このサイトは、汎用的なインストールコマンドを前提としていません。
使い捨てプロジェクトまたはコピーで、元のワークフローを試してみてください。ファイル、リモートサービス、または課金対象リソースを変更する操作は、許可する前に必ず確認してください。
出力結果をソースの品質チェックおよび独自の要件と照らし合わせて検証してください。トリガーが成功したことやリポジトリのスター数が多いことだけでは、正しい結果とは言えません。

スキルフォーマットとディレクトリの仕様 ↗

詳細は出典元をご覧ください。

翻訳と範囲

この読書ガイドは、ピン留めされた上流からの抜粋を選りすぐっていますSKILL.md翻訳は補助的なものです。完全なマニュアルではなく、互換性テスト済みであることを保証するものでもありません。ご使用前に原文および参照ファイルをお読みください。

この紹介文は、下記に固定表示されているバージョンに関するものです。現在のリポジトリのアクティビティと収集時間は別途表示されます。

ピン留めされたソース: 原文を読む ↗
ソースを取得しました: 2026-10-29T09:32:23Z
ソースコミット: fabc634a893f62ad5c2039830397efa35fa62715
ソースSHA-256: c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8

スキルカタログ全体に戻る