uv 설치하기¶

설치 방법¶

uv를 독립 실행형 설치 프로그램이나 원하는 패키지 관리자를 통해 설치한다.

독립 실행형 설치 프로그램¶

uv는 다운로드 및 설치를 위한 독립 실행형 설치 프로그램을 제공한다.

=== "macOS와 Linux"

`curl`을 사용해 스크립트를 다운로드하고 `sh`로 실행한다:

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

시스템에 `curl`이 없으면 `wget`을 사용할 수 있다:

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

URL에 특정 버전을 포함해 요청할 수 있다:

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

=== "Windows"

`irm`을 사용해 스크립트를 다운로드하고 `iex`로 실행한다:

```console
$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

[실행 정책](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.4#powershell-execution-policies)을 변경하면 인터넷에서 스크립트를 실행할 수 있다.

URL에 특정 버전을 포함해 요청할 수 있다:

```console
$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/0.6.2/install.ps1 | iex"
```

팁

설치 스크립트를 실행하기 전에 내용을 확인할 수 있다:

=== "macOS와 Linux"

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

=== "Windows"

```console
$ 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

Note

uv는 여러 플랫폼을 위한 사전 빌드된 배포판(wheel)을 제공한다. 특정 플랫폼에 대한 wheel이 없는 경우, uv는 소스에서 빌드되며 이 경우 Rust 툴체인이 필요하다. 소스에서 uv를 빌드하는 방법에 대한 자세한 내용은 기여 가이드를 참고한다.

Cargo¶

uv는 Cargo를 통해 설치할 수 있지만, 아직 공개되지 않은 크레이트에 의존하고 있기 때문에 crates.io가 아닌 Git에서 빌드해야 한다.

$ cargo install --git https://github.com/astral-sh/uv uv

Homebrew¶

uv는 Homebrew의 핵심 패키지로 제공된다.

$ brew install uv

WinGet¶

uv는 WinGet을 통해 설치할 수 있다.

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

Scoop¶

uv는 Scoop을 통해 설치할 수 있다.

$ scoop install main/uv

Docker¶

uv는 ghcr.io/astral-sh/uv에서 Docker 이미지를 제공한다.

자세한 내용은 Docker에서 uv 사용하기 가이드를 참고한다.

GitHub 릴리스¶

uv 릴리스 아티팩트는 GitHub 릴리스에서 직접 다운로드할 수 있다.

각 릴리스 페이지에는 지원되는 모든 플랫폼용 바이너리와 함께 astral.sh 대신 github.com을 통해 독립 실행형 설치 프로그램을 사용하는 방법에 대한 지침이 포함되어 있다.

uv 업그레이드¶

uv를 독립 실행형 설치 프로그램으로 설치한 경우, 필요할 때마다 자체 업데이트를 수행할 수 있다:

$ uv self update

Tip

uv를 업데이트하면 설치 프로그램이 다시 실행되고, 셸 프로필이 수정될 수 있다. 이 동작을 비활성화하려면 INSTALLER_NO_MODIFY_PATH=1을 설정한다.

다른 설치 방법을 사용한 경우, 자체 업데이트 기능이 비활성화된다. 대신 패키지 관리자의 업그레이드 방법을 사용한다. 예를 들어, pip를 사용할 경우:

$ pip install --upgrade uv

셸 자동 완성¶

Tip

현재 사용 중인 셸을 확인하려면 echo $SHELL 명령어를 실행한다.

uv 커맨드에 대한 셸 자동 완성을 활성화하려면 다음 중 하나를 실행한다:

=== "Bash"

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

=== "Zsh"

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

=== "fish"

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

=== "Elvish"

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

=== "PowerShell / pwsh"

```powershell
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"

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

=== "Zsh"

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

=== "fish"

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

=== "Elvish"

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

=== "PowerShell / pwsh"

```powershell
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'
```

그런 다음 셸을 재시작하거나 셸 설정 파일을 다시 불러온다.

제거 방법¶

시스템에서 uv를 제거하려면 다음 단계를 따르면 된다.

저장된 데이터 정리 (선택 사항):
```
$ uv cache clean
$ rm -r "$(uv python dir)"
$ rm -r "$(uv tool dir)"
```
Tip

바이너리를 제거하기 전에 uv가 저장한 데이터를 먼저 정리하는 것이 좋다.
uv와 uvx 바이너리 제거:

=== "macOS와 Linux"
```
```console
$ rm ~/.local/bin/uv ~/.local/bin/uvx
```
```
=== "Windows"
```
```powershell
$ rm $HOME\.local\bin\uv.exe
$ rm $HOME\.local\bin\uvx.exe
```
```
Note

0.5.0 버전 이전에는 uv가 ~/.cargo/bin에 설치되었다. 이전 버전에서 업그레이드할 경우 ~/.cargo/bin에 있는 바이너리가 자동으로 제거되지 않으므로, 수동으로 제거해야 한다.

다음 단계¶

첫걸음을 살펴보거나 바로 가이드로 이동해 uv를 사용해 본다.