Установка uv

Способы установки

Установите uv с помощью автономного установщика или любого удобного пакетного менеджера.

Автономный установщик

uv предоставляет автономный установщик для загрузки и установки:

macOS и Linux

Скачайте скрипт через curl и выполните его через sh:

$ curl -LsSf https://astral.sh/uv/install.sh | sh

Если в системе нет curl, можно использовать wget:

$ wget -qO- https://astral.sh/uv/install.sh | sh

Чтобы запросить конкретную версию, укажите её в URL:

$ curl -LsSf https://astral.sh/uv/0.10.7/install.sh | sh

Windows

Скачайте скрипт через irm и выполните его через iex:

PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Изменение политики выполнения позволяет запускать скрипты из интернета.

Чтобы запросить конкретную версию, укажите её в URL:

PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/0.10.7/install.ps1 | iex"

Совет: Скрипт установки можно просмотреть перед запуском:

macOS и Linux:

$ curl -LsSf https://astral.sh/uv/install.sh | less

Windows:

PS> powershell -c "irm https://astral.sh/uv/install.ps1 | more"

Либо установщик или бинарники можно скачать напрямую с GitHub.

Подробнее о настройке установки uv см. в справочной документации по установщику.

PyPI

uv публикуется на PyPI для удобства.

При установке из PyPI рекомендуется ставить uv в изолированное окружение, например через pipx:

$ pipx install uv

Можно также использовать pip:

$ pip install uv

Примечание: uv поставляется с предсобранными дистрибутивами (wheels) для многих платформ; если wheel для вашей платформы недоступен, uv будет собран из исходников, для чего нужна цепочка инструментов Rust. Подробнее о сборке uv из исходников см. в руководстве по настройке для разработки.

Homebrew

uv доступен в основных пакетах Homebrew.

$ brew install uv

MacPorts

uv доступен через MacPorts.

$ sudo port install uv

WinGet

uv доступен через WinGet.

$ winget install --id=astral-sh.uv  -e

Scoop

uv доступен через Scoop.

$ scoop install main/uv

Docker

uv предоставляет Docker-образ в ghcr.io/astral-sh/uv.

Подробнее см. в руководстве использование uv в Docker.

GitHub Releases

Артефакты релизов uv можно скачать напрямую с GitHub Releases.

На странице каждого релиза есть бинарники для всех поддерживаемых платформ и инструкции по использованию автономного установщика через github.com вместо astral.sh.

Cargo

uv доступен через crates.io.

$ cargo install --locked uv

Примечание: Этот способ собирает uv из исходников и требует совместимой цепочки инструментов Rust.

Обновление uv

При установке через автономный установщик uv может обновляться по запросу:

$ uv self update

Совет: Обновление uv перезапускает установщик и может изменить профили оболочки. Чтобы отключить это, задайте UV_NO_MODIFY_PATH=1.

При установке другим способом самообновление отключено. Используйте способ обновления вашего пакетного менеджера. Например, для pip:

$ pip install --upgrade uv

Автодополнение в оболочке

Совет: Команда echo $SHELL подскажет, какая у вас оболочка.

Чтобы включить автодополнение команд uv в оболочке, выполните одну из следующих команд:

Bash:

echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

Zsh:

echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc

fish:

echo 'uv generate-shell-completion fish | source' > ~/.config/fish/completions/uv.fish

Elvish:

echo 'eval (uv generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv

PowerShell / pwsh:

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'

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

Bash:

echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc

Zsh:

echo 'eval "$(uvx --generate-shell-completion zsh)"' >> ~/.zshrc

fish:

echo 'uvx --generate-shell-completion fish | source' > ~/.config/fish/completions/uvx.fish

Elvish:

echo 'eval (uvx --generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv

PowerShell / pwsh:

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
Add-Content -Path $PROFILE -Value '(& uvx --generate-shell-completion powershell) | Out-String | Invoke-Expression'

После этого перезапустите оболочку или выполните source для файла конфигурации оболочки.

Удаление

Чтобы удалить uv с системы, выполните следующие шаги.

Очистка сохранённых данных (по желанию):

$ uv cache clean
$ rm -r "$(uv python dir)"
$ rm -r "$(uv tool dir)"

Совет: Перед удалением бинарников можно удалить данные, которые сохранял uv. Подробнее о расположении данных см. в справочнике по хранилищу.

Удаление бинарников uv, uvx и uvw:

macOS и Linux:

$ rm ~/.local/bin/uv ~/.local/bin/uvx

Windows:

PS> rm $HOME\.local\bin\uv.exe
PS> rm $HOME\.local\bin\uvx.exe
PS> rm $HOME\.local\bin\uvw.exe

Примечание: До версии 0.5.0 uv устанавливался в ~/.cargo/bin. Бинарники можно удалить оттуда для полного удаления. Обновление со старой версии не удаляет бинарники из ~/.cargo/bin автоматически.

Дальнейшие шаги

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