python / / 2025. 1. 21. 09:43

python의 uv 사용법

uv는 python 패키지 설치 및 관리, 빌드, 배포까지 가능하며 엄청난 속도를 자랑합니다.

https://github.com/astral-sh/uv

  • uv는 pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv 등을 대체할 하나의 도구이다.
  • pip보다 10-100배 빠르다.
  • python 애플리케이션에서 실행 및 설치된다.

설치

macOS 또는 Linux

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

또는 
brew install uv

Windows

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

PyPI로 설치

# With pip.
pip install uv

# Or pipx.
pipx install uv

설치 후 최신 버전 업데이트

uv self update

기능

초기화 (example 프로젝트)

uv init example

example 프로젝트에 대해 uv 환경을 구성합니다. 이때 pyproject.toml 파일을 새로 생성합니다.

의존성 추가

uv add ruff

특정 패키지를 설치합니다.

만일 버전을 명시하려면 아래와 같이 실행하면 됩니다.

uv add ruff==2.2.2

의존성 삭제

uv remove ruff

특정 패키지를 삭제하려면 remove를 사용하면 됩니다.

개발용으로 추가

uv add ruff --dev

extra로 추가할 경우

기존에는 pip install "uvicorn[standard]"으로 추가함

uv add uvicorn --extra standard

uv export

requirements.txt로 만들 때

uv export -o requirements.txt

python 설치

uv python install 3.12

uv 환경에서 python 3.12 버전을 설치합니다.

가상환경

uv venv

python 3.12로 가상환경을 생성합니다.

특정 python version으로 만들려면 아래와 같이 버전을 명시하면 됩니다.

uv venv --python 3.12

requirements.txt 생성

uv export -o requirements.txt

uv run

uv run hello.py

특정 프로그램을 실행할 때 사용하면 됩니다.

pip로 설치

uv pip install ruff

pip를 uv로 실행하는 겁니다. uv pip로 설치하면 pyproject.toml과 uv.lock은 변경되지 않습니다.

python 관리

여러개의 python 버전 설치

uv python install 3.10 3.11 3.12

Installed 3 versions in 13.26s
 + cpython-3.10.16-macos-aarch64-none
 + cpython-3.11.11-macos-aarch64-none
 + cpython-3.12.8-macos-aarch64-none

가상환경 생성

uv venv --python 3.12.0

Using CPython 3.12.0
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

참고

반응형
  • 네이버 블로그 공유
  • 네이버 밴드 공유
  • 페이스북 공유
  • 카카오스토리 공유