$ sudo teach IT
Модуль 1 · Знакомство · Урок 1.2

Установка uv

Вы поставите uv одной командой и проверите, что он работает.

Теория + практика~5 минутНовичок

Вы знаете, что uv заменяет несколько инструментов. Чтобы им пользоваться, его надо поставить: это одна команда.

Одна команда

Ставим официальным установщиком: он скачивает uv и кладёт его в вашу домашнюю папку (~/.local/bin). Откройте терминал и вставьте строку для своей системы.

Терминал · macOS и Linux
$ curl -LsSf https://astral.sh/uv/install.sh | sh
Терминал · PowerShell (Windows)
$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Всё. Через несколько секунд uv на компьютере. Установщик пишет только в вашу папку.

Разбор по строкам

  • curl -LsSf https://astral.sh/uv/install.sh — скачивает установщик.
  • | sh — передаёт скачанное оболочке, и она его выполняет.
  • irm ... | iex (PowerShell) — то же самое: irm скачивает скрипт, iex выполняет.
  • -ExecutionPolicy ByPass — разрешает запустить скрипт из интернета только в этом одном запуске.

Есть и другие способы

Подойдут и менеджеры программ: brew install uv (macOS), winget install --id=astral-sh.uv -e (Windows) или pipx install uv.

Проверяем

Закройте терминал и откройте заново: так он увидит новую программу.

Терминал
$ uv --version
Вывод
uv 0.13.9

Номер появился — uv работает. У вас цифры могут быть новее, это нормально.

Частые ошибки

Вместо версии пишет zsh: command not found: uv (или bash: uv: command not found). Терминал не знает о новой программе, потому что вы не перезапустили его после установки. Закройте окно, откройте новое и повторите uv --version.

Обновление

Когда выйдет новая версия, uv обновит сам себя:

Терминал
$ uv self update

Это работает, если вы ставили скриптом. Если ставили через brew, winget или pipx, обновляйте тем же способом, например brew upgrade uv.

Попробуйте

Введите uv help. Появится список всех команд uv. Найдите в нём run, add и init: с них начнётся работа в следующих уроках.

Терминал
$ uv help
Вывод (начало)
An extremely fast Python package manager.

Usage: uv [OPTIONS] <COMMAND>

Commands:
  auth                       Manage authentication
  run                        Run a command or script
  init                       Create a new project
  add                        Add dependencies to the project
  remove                     Remove dependencies from the project

Что запомнить

  • uv ставится одной командой: curl ... | sh на macOS и Linux, irm ... | iex в PowerShell.
  • После установки откройте терминал заново и проверьте: uv --version.
  • Обновление — uv self update (если ставили скриптом).

uv стоит. Дальше запустим первый скрипт, даже не думая, есть ли у вас нужный Python.

На следующий урок
Установка uv — uv для начинающих бесплатно: проект на Python за час | $ sudo teach IT