Panduan membaca yang dilokalisasi

hf-cloud-python-env-setupTujuan, penggunaan, dan sumber

Siapkan lingkungan Python terisolasi untuk pekerjaan SageMaker/AWS, dengan versi Python yang tepat dan bot terbaru.3Gunakan keahlian ini setiap kali kode Python akan dieksekusi untuk penerapan SageMaker, pekerjaan pelatihan, atau otomatisasi AWS apa pun — termasuk saat akan menjalankanpip install, ketika hendak memanggilboto3, saat membuat atau mengaktifkan virtualenv, atau saat pengguna meminta untuk "menyiapkan lingkungan". Jangan pernah menggunakan Python sistem dan jangan pernahpip installke dalamnya. Selalu isolasi. Keterampilan ini mencegah mode kegagalan yang paling umum: versi Python yang salah, konflik dependensi, dan SDK yang usang.

Sumber diambil: 2026-10-29

Repositori sumber: huggingface/skills
SKILL.md: skills/hf-cloud-python-env-setup/SKILL.md
Bintang Repositori: 11,241
Pembaruan terakhir repositori: 2026-10-30
Klasifikasi Kemampuan: layanan cloud
Waktu pengumpulan terbaru: 2026-10-31 10:38 UTC+08:00

Lisensi: Apache-2.0

SKILL.md asli

Cuplikan alur kerja adalah alat bantu baca, bukan instruksi yang dapat dieksekusi dari Codez. Tidak ada Skill pihak ketiga yang dijalankan untuk menghasilkan halaman ini.

Bagian yang menjelaskan tujuan dan alur kerja di bawah ini merupakan materi dari hulu, yang telah diorganisir dan diterjemahkan untuk dibaca. Bagian ini berbeda dari analisis editorial Codez yang diberi label secara terpisah.

Apa yang dilakukan oleh Skill ini?

Bagaimana alur kerja hulu bekerja

Cara mengatur

Cara tercepat adalah menggunakan skrip yang sudah disertakan — skrip ini menggunakan Python, sehingga berjalan sama di Windows, macOS, dan Linux: Skrip ini mendeteksiuvdan menggunakannya jika tersedia (lebih cepat), jika tidak, akan menggunakan pustaka standar (stdlib) jika tidak tersedia.venvmodul, membuat.venv/dengan Python3.12(mengesampingkan:python3 setup_env.py .venv 3.11), menolak versi Python yang tidak didukung, menginstal dari paket yang disertakanrequirements.txt, dan bersifat idempoten. Ia juga mencetak jalur interpreter yang benar untuk OS host (lihat di bawah). Setelah pengaturan, panggil Python env secara eksplisit daripada mengaktifkan venv. Jalur interpreter berbeda-beda tergantung platform: Ini bekerja sama dalam skrip, shell interaktif, dan panggilan alat agen. Sisa dari keterampilan ini menulis.venv/bin/pythonuntuk mempersingkat — pada Windows ganti.venv\Scripts\python.exe.

Jalur hulu · L31 ↗

boto3vs SDK SageMaker

Dua kasus SDK spesifik yang masih perlu diperhatikan:

Jalur hulu · L18 ↗

Jalur hulu · bash ↗

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

Persyaratan dan pengaturan

Pengaturan Lingkungan Python untuk SageMaker

Sebagian besar kegagalan penerapan SageMaker yang tampak seperti masalah AWS sebenarnya adalah masalah lingkungan Python: versi Python yang salah, resolusi dependensi yang rusak, SDK usang yang tidak mengetahui API terbaru. Keterampilan ini membuat pengaturan lingkungan menjadi membosankan dan benar.

Jalur hulu · L6 ↗

Batasan dan pemeriksaan kualitas

Jebakan umum

Misteriuspip installKesalahan resolusi Hampir selalu Python3.13+ mencoba menginstal paket tanpa wheel terlebih dahulu, atau menginstal ke sistem Python yang terkontaminasi. Buat ulang di3.12: menghapus.venvdan dijalankan ulangpython3 setup_env.py .venv 3.12(skrip ini membuat ulang lingkungan ketika versinya tidak cocok, jadi Anda juga bisa menjalankannya kembali).pip installBerhasil tetapi skrip mengatakan "modul tidak ditemukan". Anda menginstalnya ke interpreter yang berbeda dari yang menjalankan skrip. Selalu panggil Python secara eksplisit:.venv/bin/python -m pip install ...Dan.venv/bin/python deploy.py.

Jalur hulu · L75 ↗

Aturan inti

Jangan pernah menggunakan Python sistem. Selalu bekerja di dalam lingkungan terisolasi. Tetapkan versi Python, bukan versi paket. Gunakan3.10,3.11, atau3.12. Menghindari3.13+ — Pustaka ML tertinggal dalam ketersediaan wheel dan resolusi dependensi mengalami masalah dengan cara yang membingungkan. Instal versi terbaru dari setiap paket. Jangan terpaku pada versi terbaru.boto3atauawscliVersi yang lebih baru memiliki antarmuka API terkini dan perbaikan keamanan. Hanya terapkan versi tertentu jika pengguna secara eksplisit memerlukan versi spesifik. Periksa versi yang terpasang dengan benar. Gunakanimportlib.metadata.version("package-name"), tidak pernahmodule.__version__Yang terakhir tidak konsisten di berbagai paket.

Jalur hulu · L10 ↗

Mulailah dengan uji coba yang aman.

Periksa host yang didukung dan petunjuk instalasi repositori. Simpan direktori Skill beserta skrip, aset, dan dokumentasi yang dirujuk di dalamnya secara bersamaan;SKILL.mdsendirian dapat menghilangkan dependensi.
Berikan input sebenarnya, output yang diinginkan, dan kriteria penerimaan kepada agen. Sintaks pemanggilan dan alat yang tersedia bergantung pada host; situs ini tidak mengasumsikan perintah instalasi universal.
Cobalah alur kerja sumber dalam proyek sementara atau pada salinannya. Tinjau operasi yang mengubah file, layanan jarak jauh, atau sumber daya yang dapat ditagih sebelum mengizinkannya.
Validasi output terhadap pemeriksaan kualitas sumber dan persyaratan Anda sendiri. Pemicu yang berhasil atau jumlah bintang repositori yang tinggi tidak menjamin hasil yang benar.

Spesifikasi format dan direktori keterampilan ↗

Baca selengkapnya di sumber aslinya.

Terjemahan dan ruang lingkup

Panduan membaca ini memilih bagian-bagian dari teks yang telah disematkan di bagian atas.SKILL.mdTerjemahan ini dibantu. Ini bukan manual lengkap atau klaim kompatibilitas yang telah diuji. Bacalah dokumen asli dan file referensinya sebelum digunakan.

Pendahuluan ini mengacu pada versi yang disematkan di bawah ini; aktivitas repositori saat ini dan waktu pengumpulan ditampilkan secara terpisah.

Sumber yang disematkan: Baca teks aslinya ↗
Sumber diambil: 2026-10-29T09:32:23Z
Komit sumber: fabc634a893f62ad5c2039830397efa35fa62715
Sumber SHA-256: c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8

Kembali ke katalog Keterampilan lengkap