현지화된 읽기 가이드
hf-cloud-python-env-setup목적, 사용법 및 출처
SageMaker/AWS 작업을 위한 격리된 Python 환경을 올바른 Python 버전과 최신 boto를 사용하여 설정하십시오.3이 스킬은 SageMaker 배포, 학습 작업 또는 AWS 자동화를 위해 Python 코드가 실행될 때마다, 특히 실행 직전에 사용하십시오.pip install, 호출하기 직전에boto3가상 환경을 생성하거나 활성화할 때, 또는 사용자가 "환경 설정"을 요청할 때 시스템 Python을 절대 사용하지 마십시오.pip install그 안에 들어가세요. 항상 격리하세요. 이 기술은 가장 흔한 오류 유형인 잘못된 Python 버전, 종속성 충돌 및 오래된 SDK를 방지합니다.
출처 검색됨:
- 소스 저장소
- huggingface/skills
- SKILL.md
skills/hf-cloud-python-env-setup/SKILL.md- 저장소 Star
- 11,241
- 저장소 최근 업데이트
- 2026-10-30
- 능력 분류
- 클라우드 서비스
- 최근 수집 시간
라이선스: Apache-2.0
워크플로 발췌본은 이해를 돕기 위한 자료이며, Codez에서 제공하는 실행 가능한 명령어가 아닙니다. 이 페이지를 생성하는 데 타사 Skill은 사용되지 않았습니다.
아래의 목적 및 워크플로 관련 내용은 읽기 쉽도록 정리 및 번역된 상위 자료입니다. 이는 별도로 분류된 Codez 편집 분석과는 별개입니다.
이 스킬의 기능
SageMaker/AWS 작업을 위한 격리된 Python 환경을 올바른 Python 버전과 최신 boto를 사용하여 설정하십시오.3이 스킬은 SageMaker 배포, 학습 작업 또는 AWS 자동화를 위해 Python 코드가 실행될 때마다, 특히 실행 직전에 사용하십시오.pip install, 호출하기 직전에boto3가상 환경을 생성하거나 활성화할 때, 또는 사용자가 "환경 설정"을 요청할 때 시스템 Python을 절대 사용하지 마십시오.pip install그 안에 들어가세요. 항상 격리하세요. 이 기술은 가장 흔한 오류 유형인 잘못된 Python 버전, 종속성 충돌 및 오래된 SDK를 방지합니다.
업스트림 워크플로우 작동 방식
설정 방법
가장 빠른 방법은 함께 제공되는 스크립트를 사용하는 것입니다. 이 스크립트는 파이썬으로 작성되었으므로 Windows, macOS, Linux에서 동일하게 실행됩니다. 이 스크립트는 다음을 감지합니다.uv사용 가능한 경우(더 빠름) 해당 라이브러리를 사용하고, 그렇지 않을 경우 표준 라이브러리를 사용합니다.venv모듈은 생성합니다..venv/파이썬을 사용하여3.12(보수:python3 setup_env.py .venv 3.11지원되지 않는 Python 버전을 거부하고, 번들로 제공되는 패키지에서 설치합니다.requirements.txt또한 멱등성을 갖습니다. 호스트 운영 체제에 맞는 올바른 인터프리터 경로도 출력합니다(아래 참조). 설정 후에는 가상 환경을 활성화하는 대신 환경의 Python을 명시적으로 호출하십시오. 인터프리터 경로는 플랫폼에 따라 다릅니다. 이 기능은 스크립트, 대화형 셸 및 에이전트 도구 호출에서 동일하게 작동합니다. 이 스킬의 나머지 부분은 다음과 같습니다..venv/bin/python간결함을 위해 — 윈도우에서는 대체.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 버전, 잘못된 종속성 해결, 최신 API를 인식하지 못하는 오래된 SDK 때문입니다. 이 스킬을 사용하면 환경 설정이 지루하지 않고 정확하게 이루어집니다.
상류 통로 · L6 ↗제한 사항 및 품질 검사
흔히 저지르는 실수
신비로운pip install해상도 오류는 거의 항상 Python에서 발생합니다.3.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.
핵심 규칙
시스템 파이썬은 절대 사용하지 마십시오. 항상 격리된 환경에서 작업하십시오. 패키지 버전이 아닌 파이썬 버전을 고정하십시오.3.10,3.11, 또는3.12. 피하다3.13+ — 머신러닝 라이브러리는 wheel 패키지 제공이 지연되고, 종속성 해결 과정에서 혼란스러운 문제가 발생할 수 있습니다. 각 패키지의 최신 버전을 설치하세요. 특정 버전을 고정(pinning)하지 마세요.boto3또는awscli최신 버전은 최신 API 인터페이스와 보안 수정 사항을 포함하고 있습니다. 사용자가 특정 버전을 명시적으로 요구하는 경우에만 버전을 고정하십시오. 설치된 버전을 정확하게 확인하십시오.importlib.metadata.version("package-name"), 절대module.__version__후자는 패키지마다 일관성이 없습니다.
안전한 시험 사용부터 시작하세요
- 지원되는 호스트와 저장소 설치 지침을 확인하세요. 스킬 디렉토리와 해당 디렉토리에서 참조하는 스크립트, 자산 및 문서를 함께 보관하세요.SKILL.md단독으로는 종속성을 생략할 수 있습니다.
- 에이전트에 실제 입력값, 원하는 출력값 및 승인 기준을 제공하십시오. 호출 구문 및 사용 가능한 도구는 호스트에 따라 다르므로 이 사이트는 범용 설치 명령을 제공하지 않습니다.
- 원본 워크플로를 임시 프로젝트 또는 복사본에서 테스트해 보세요. 파일, 원격 서비스 또는 유료 리소스를 변경하는 작업은 허용하기 전에 검토하십시오.
- 출력 결과를 원본 품질 검사 및 자체 요구 사항에 맞춰 검증하십시오. 트리거가 성공적으로 작동했거나 저장소의 별점 수가 높다고 해서 반드시 올바른 결과가 나오는 것은 아닙니다.
원문에서 더 자세한 내용을 읽어보세요.
관련 기술
번역 및 범위
이 독서 안내서는 고정된 상류 지역에서 발췌한 구절들을 소개합니다.SKILL.md본 번역은 보조 번역이며, 완전한 설명서 또는 호환성 테스트를 보장하는 것은 아닙니다. 사용 전에 원본 및 참조 파일을 반드시 읽어 주십시오.
이 소개글은 아래 고정된 버전을 참조하며, 현재 저장소 활동 및 수집 시간은 별도로 표시됩니다.
- 고정된 소스
- 원문을 읽어보세요 ↗
- 출처 검색됨
- 소스 커밋
fabc634a893f62ad5c2039830397efa35fa62715- 출처 SHA-256
c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8