Наш баннер живёт на Python 3.15. А если нужна другая версия? С uv это пара команд.
Какие Python есть и как поставить ещё один
Сначала посмотрим, что uv уже нашёл на вашем компьютере:
$ uv python list --only-installed
cpython-3.15.2-macos-aarch64-none ~/.local/bin/python3.15
cpython-3.13.2-macos-aarch64-none /usr/local/bin/python3.13
cpython-3.9.6-macos-aarch64-none /usr/bin/python3
Это фрагмент, у вас строки будут свои. Без --only-installed uv покажет и версии, которые можно скачать. Нужной нет? Скачиваем:
$ uv python install 3.14
Installed Python 3.14.10
+ cpython-3.14.10-macos-aarch64-none (python3.14)
Всё. Появилась ещё одна копия Python, системный Python uv не трогает.
Два файла про версию
Версия Python записана в проекте в двух местах, и роли у них разные. Как с поездом: .python-version — это билет на конкретный поезд («едем на этой версии сейчас»), а requires-python — правило перевозчика («подойдёт любой поезд не старше этого»).
3.15
requires-python = ">=3.15"
Разбор по строкам
.python-version— какую версию uv берёт для запуска прямо сейчас:3.15.requires-python = ">=3.15"— какие версии проект вообще допускает: 3.15 и новее.
Меняем версию: uv python pin
Команда uv python pin перезаписывает .python-version. Попробуем выбрать 3.14:
$ uv python pin 3.14
error: The requested Python version `3.14` is incompatible with the project `requires-python` value of `>=3.15`.
Ошибка по делу: проект не допускает 3.14. Сначала разрешаем её в pyproject.toml:
requires-python = ">=3.14"
Теперь пин проходит, а uv run сам пересоздаёт .venv под новую версию:
$ uv python pin 3.14
$ uv run python --version
Updated `.python-version` from `3.15` -> `3.14`
Using CPython 3.14.10
Removed virtual environment at: .venv
Creating virtual environment at: .venv
Installed 7 packages
Python 3.14.10
Вернуть 3.15 — так же: requires-python обратно в ">=3.15", затем uv python pin 3.15.
Ошибка incompatible
Если uv python pin пишет incompatible, поменяйте requires-python в pyproject.toml и повторите команду.
Попробуйте
- В папке проекта выполните
uv run python --version— увидите версию из.python-version. - Выйдите из папки проекта (
cd ..) и повторите: вне проекта uv берёт любой найденный Python, версия может отличаться.
Что запомнить
uv python listпоказывает, какие Python есть, аuv python install 3.14скачивает ещё один..python-version— версия «сейчас»,requires-python— какие версии проект допускает.uv python pin 3.14меняет версию проекта, но только в рамкахrequires-python.
Модуль закончен. Дальше — uv в работе: инструменты, старые проекты, Docker.