sitdraw

Как установить и использовать uv: проект Python, пакет и запуск скрипта

По официальным шагам установить uv, инициализировать проект, добавить пакет и запустить скрипт через uv run.

Чтобы вести проект Python локально через uv, закройте четыре шага: официальная установка, uv init, uv add одного пакета, затем uv run скрипта.

Идите по docs.astral.sh/uv/, не угадывайте пакеты. Запросы: установить uv, uv init, запуск скрипта через uv run. Установщик: astral.sh/uv.

uvИмя команды Astral
initпишет pyproject.toml
runзапуск в окружении проекта

Поставить официальный бинарник под ОС

macOS и Linux

Официальный скрипт: curl -LsSf https://astral.sh/uv/install.sh | sh. Или brew install uv. Новый терминал, uv --version.

Windows

PowerShell: irm https://astral.sh/uv/install.ps1 | iex. Новая сессия: uv должен быть в PATH.

ШагКомандаНа что смотреть
Установкаuv --versionТекущая оболочка должна видеть официальный бинарник
Проектuv init myprojectдолжен появиться pyproject.toml
Зависимостьuv add httpxимя с PyPI; lockfile обновляется
Скриптuv run python hello.pyокружение проекта; ручной activate не нужен

Установка, создание, пакет, запуск

  1. 01
    Установить и сверить версию

    docs.astral.sh/uv/getting-started/installation/ — скрипт или Homebrew. uv --version должен напечатать версию. Нет команды — новый терминал и PATH.

  2. 02
    Создать проект

    В родительском каталоге uv init myproject, затем cd myproject. Должен быть pyproject.toml. Пустая папка: просто uv init.

  3. 03
    Добавить один пакет

    Пример: uv add httpx. uv разрешает зависимости, пишет lockfile, готовит окружение. При ошибке проверьте имя и сеть; не правьте недописанный lockfile руками.

  4. 04
    Написать и запустить скрипт

    Создайте hello.py с новым пакетом, затем uv run python hello.py. Чтобы зафиксировать интерпретатор, сначала uv python install.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv init myproject
cd myproject
uv add httpx
# После hello.py:
uv run python hello.py
Обязателен ли официальный скрипт?
Нет. В документах есть Homebrew, WinGet и другие каналы. Выберите один и проверьте uv --version. Не ставьте несколько копий, которые дерутся за PATH.
Нужно ли самому создавать venv?
В повседневной работе нет. uv add и uv run используют окружение проекта. Добавьте .venv в .gitignore, не коммитьте.
Чем uv run отличается от python?
Системный python может не видеть зависимости проекта. uv run выбирает интерпретатор и пакеты проекта.
Заменяет ли установка общую схему?
Нет. Это Python toolchain. Если встреча — та же схема, откройте sitdraw.

Сначала uv в PATH

Пока uv --version не работает, не считайте упавший init ошибкой шаблона. Чаще оболочка не подхватила PATH, который изменил установщик.

Начать картину