Локализованное руководство по чтению

hf-cloud-python-env-setupНазначение, использование и источник

Настройте изолированную среду Python для работы с SageMaker / AWS, используя правильную версию Python и текущий boto.3Используйте этот навык всякий раз, когда код Python будет выполняться для развертывания SageMaker, задания обучения или любой автоматизации AWS — в том числе и перед запуском.pip installкогда собирается призватьboto3Никогда не используйте системный Python и никогда не используйте Python при создании или активации виртуальной среды, а также когда пользователь запрашивает «настройку среды».pip installВникайте в это. Всегда изолируйте. Этот навык предотвращает наиболее распространенные сбои: неправильную версию Python, конфликты зависимостей и устаревшие SDK.

Источник получен: 2026-10-29

Репозиторий-источник: huggingface/skills
SKILL.md: skills/hf-cloud-python-env-setup/SKILL.md
Звёзды репозитория: 11,241
Последнее обновление репозитория: 2026-10-30
Категории Skills: Облачные сервисы
Время последнего сбора: 2026-10-31 10:38 UTC+08:00

Лицензия: Apache-2.0

Оригинальный файл SKILL.md

Приведенные фрагменты описания рабочих процессов являются вспомогательными средствами для чтения, а не исполняемыми инструкциями от Codez. Для создания этой страницы не использовались сторонние инструменты.

Приведённые ниже фрагменты, описывающие цели и рабочие процессы, представляют собой исходный материал, систематизированный и переведённый для удобства чтения. Они отличаются от отдельно обозначенного редакционного анализа Codez.

Что делает этот навык

Как работает рабочий процесс на вышестоящем уровне

Как настроить

Самый быстрый способ — использовать встроенный скрипт — он написан на Python, поэтому работает одинаково в Windows, macOS и Linux: Этот скрипт обнаруживаетuvи использует его, если он доступен (быстрее), в случае необходимости переключается на стандартную библиотеку.venvмодуль, создает.venv/с помощью Python3.12(переопределение:python3 setup_env.py .venv 3.11), отклоняет неподдерживаемые версии Python, устанавливает из встроенного пакета.requirements.txtи является идемпотентным. Он также выводит правильный путь к интерпретатору для хостовой ОС (см. ниже). После настройки запустите Python из среды явно, а не активируйте виртуальное окружение. Путь к интерпретатору различается в зависимости от платформы: это работает одинаково в скриптах, интерактивных оболочках и вызовах инструментов агента. Остальная часть этого навыка пишет.venv/bin/pythonДля краткости — в Windows замените.venv\Scripts\python.exe.

проход вверх по течению · L31 ↗

бото3против SDK SageMaker

Два конкретных случая использования SDK, требующих внимания:

проход вверх по течению · L18 ↗

проход вверх по течению · bash ↗

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

Требования и настройка

Настройка среды Python для SageMaker

Большинство сбоев развертывания SageMaker, которые выглядят как проблемы с AWS, на самом деле являются проблемами среды Python: неправильная версия Python, некорректное разрешение зависимостей, устаревший SDK, который не знает о текущем API. Этот навык делает настройку среды скучной и правильной.

проход вверх по течению · L6 ↗

Ограничения и проверки качества

Распространенные ошибки

Загадочныйpip installОшибки разрешения. Почти всегда в Python.3.13+ Попытки установить пакеты без пакетов wheel или установить 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+ — Библиотеки машинного обучения отстают в плане доступности пакетов wheel и разрешения зависимостей, что приводит к путанице. Устанавливайте последние версии каждого пакета. Не закрепляйте изменения в целях самозащиты.boto3илиawscliБолее новые версии имеют актуальный API и исправления безопасности. Закрепляйте версию только в том случае, если пользователь явно требует конкретную версию. Проверяйте правильность установленных версий. Используйтеimportlib.metadata.version("package-name"), никогдаmodule.__version__Последнее наблюдается непоследовательно в разных пакетах.

проход вверх по течению · L10 ↗

Начните с безопасного пробного периода.

Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.

Формат навыков и спецификация каталога ↗

Подробнее читайте в источнике.

Перевод и сфера применения

В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.

Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.

Закрепленный источник: Прочитайте оригинал ↗
Источник получен: 2026-10-29T09:32:23Z
Исходный коммит: fabc634a893f62ad5c2039830397efa35fa62715
Исходный SHA-256: c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8

Вернуться к полному каталогу навыков