uv-python-versions — скилл для Claude Code: версии Python
Скилл uv-python-versions помогает управлять версиями CPython и PyPy через uv: устанавливать интерпретаторы, закреплять версию проекта и переключаться между ними.
MIT 332 установок ★ 60 обновлён 2026-11-16
npx skills add laurigates/claude-plugins --skill uv-python-versions -a claude-codeЧто делает uv-python-versions
Скилл подсказывает команды uv для установки конкретных версий Python, просмотра доступных интерпретаторов и поиска нужного. Он также помогает закрепить версию проекта через .python-version или учесть ограничение requires-python в pyproject.toml.
Для тестирования на разных версиях можно запускать команды через uv run --python или создавать отдельные виртуальные окружения командой uv venv --python. Скилл охватывает CPython и PyPy. Библиотеки проекта и глобальные CLI-инструменты относятся к другим задачам, а не к этому скиллу.
Какие задачи решает
- установить нужную версию CPython или PyPy
- закрепить версию Python в
.python-version - найти установленный интерпретатор
- запустить тесты на нескольких версиях Python
- создать виртуальное окружение с выбранным Python
Примеры запросов агенту
- Установи Python 3.12 и закрепи эту версию для проекта.
- Покажи установленные версии Python и найди интерпретатор 3.11.
- Подскажи, как запустить
pytestна Python 3.10 и 3.12 черезuv.
Как установить uv-python-versions
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-python-versions -a claude-code2Вручную: положить файлы
~/.claude/skills/uv-python-versions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/uv-python-versions/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-python-versions -a codex2Вручную: положить файлы
.agents/skills/uv-python-versions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-python-versions -a cursor2Вручную: положить файлы
.cursor/skills/uv-python-versions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install laurigates/claude-plugins python-plugin/skills/uv-python-versions2Вручную: положить файлы
.github/skills/uv-python-versions/SKILL.md1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-python-versions -a gemini-cli2Командой платформы
gemini skills install https://github.com/laurigates/claude-plugins --path python-plugin/skills/uv-python-versionsВручную: положить файлы
.devin/skills/uv-python-versions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-python-versions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об uv-python-versions
Как установить uv-python-versions в Claude Code?
Выполните npx skills add laurigates/claude-plugins --skill uv-python-versions -a claude-code. Файл скилла появится по пути ~/.claude/skills/uv-python-versions/SKILL.md.
Что делает uv-python-versions?
Скилл помогает устанавливать и находить версии CPython и PyPy с помощью uv, а также закреплять версию Python для проекта.
Можно ли использовать uv-python-versions для тестов на разных версиях Python?
Да. Он подсказывает запуск команд через uv run --python и создание отдельных окружений с помощью uv venv --python.
Исходный текст
SKILL.md · MIT
--- created: 2025-12-16 modified: 2026-11-14 reviewed: 2026-04-25 name: uv-python-versions description: Install and manage Python interpreter versions with uv. Use when the user mentions installing Python versions, .python-version, uv python, or managing CPython/PyPy. user-invocable: false allowed-tools: Bash(uv python install), Bash(uv python list), Bash(uv python list --only-installed), Bash(uv python list --verbose), Bash(uv python find), Bash(uv venv *), Bash(uv init *), Read, Grep, Glob --- # UV Python Version Management Quick reference for installing and managing Python interpreter versions with UV. ## When to Use This Skill | Use this skill when... | Use a focused sibling instead when... | |---|---| | Installing a specific CPython or PyPy interpreter with `uv python install` | Adding a Python library to a project — use uv-project-management | | Pinning a project to a Python version via `.python-version` or `requires-python` | Installing a global Python CLI tool — use uv-tool-management | | Switching between multiple installed interpreters for testing | Running a script with auto-managed Python — use uv-run | ## When This Skill Applies - Installing specific Python versions - Switching between multiple Python versions - Pinning Python versions for projects - Managing CPython and PyPy interpreters - Finding and listing installed Python versions ## Quick Reference ### Installing Python Versions ```bash # Install latest Python uv python install # Install specific version uv python install 3.11 uv python install 3.12 uv python install 3.10 3.11 3.12 # Install exact version uv python install 3.11.5 uv python install [email protected] # Install PyPy uv python install [email protected] uv python install [email protected] ``` ### Listing Python Versions ```bash # List all available versions uv python list # List only installed versions uv python list --only-installed # List with verbose details uv python list --verbose ``` ### Pinning Python Versions ```bash # Pin version for current project uv python pin 3.11 uv python pin 3.12.1 # Pin PyPy uv python pin [email protected] # Pin with version file # Creates/updates .python-version ``` ### Finding Python Interpreters ```bash # Find any Python installation uv python find # Find specific version uv python find 3.11 uv python find 3.12 # Find PyPy uv python find pypy uv python find [email protected] ``` ### Using Specific Python Versions ```bash # In project commands uv run --python 3.11 script.py uv run --python 3.12 pytest # Creating virtual environments uv venv --python 3.11 uv venv --python 3.10 .venv-py310 # Initializing projects uv init --python 3.12 my-project ``` ## Python Version Sources UV searches for Python in this order: 1. **UV-managed** - Installed via `uv python install` 2. **.python-version** - Pin file in project directory 3. **pyproject.toml** - `requires-python` field 4. **System Python** - Existing system installations 5. **Environment** - `$PATH` and standard locations ## Version Pinning ### .python-version File ```bash # Pin creates this file uv python pin 3.11 # File contents 3.11 # Exact version uv python pin 3.11.5 ``` ### pyproject.toml ```toml [project] requires-python = ">=3.11" # UV respects this constraint ``` ## Supported Python Implementations ### CPython ```bash # Default implementation uv python install 3.11 uv python install [email protected] uv python install [email protected] ``` ### PyPy ```bash # Alternative Python implementation uv python install [email protected] uv python install [email protected] ``` ## Common Commands ```bash # Install and pin latest Python 3.12 uv python install 3.12 && uv python pin 3.12 # Install multiple versions for testing uv python install 3.10 3.11 3.12 # Check which Python is active uv python find uv run python --version # Uninstall version (manual) rm -rf ~/.local/share/uv/python/cpython-3.11.5-* ``` ## Integration with Projects ### Project Initialization ```bash # Initialize with specific Python uv init --python 3.11 my-project # Generates .python-version cat .python-version # 3.11 ``` ### Running Commands ```bash # Use project's pinned Python uv run python script.py # Override with specific version uv run --python 3.12 script.py # Use system Python uv run --python python3 script.py ``` ## Multi-Version Testing ```bash # Test across Python versions uv run --python 3.10 pytest uv run --python 3.11 pytest uv run --python 3.12 pytest # Create version-specific venvs uv venv --python 3.10 .venv-py310 uv venv --python 3.11 .venv-py311 uv venv --python 3.12 .venv-py312 ``` ## Key Features - **Fast downloads**: Parallel downloads with caching - **Automatic**: Downloads versions on-demand - **Isolated**: UV-managed versions don't conflict with system Python - **Portable**: Uses standalone Python distributions - **Cross-platform**: Works on Linux, macOS, and Windows ## See Also - `uv-project-management` - Using pinned Python versions in projects - `uv-workspaces` - Python versions in monorepos - `python-testing` - Testing across multiple Python versions ## References - Official docs: https://docs.astral.sh/uv/guides/install-python/ - Python standalone builds: https://github.com/indygreg/python-build-standalone - Detailed guide: See REFERENCE.md in this skill directory
© laurigates · MIT · laurigates/claude-plugins