UV - Rust로 작성된 빠른 Python 패키지 관리자
Rust로 작성된 Python 패키지 관리자 uv를 설치하고 프로젝트 초기화, 의존성 추가와 제거, 잠금, 가상 환경 생성, 실행 방법을 정리합니다.
요약
- uv는 Rust로 작성된 Python 패키지 및 프로젝트 관리자로, pip, pip-tools, pipx, poetry, pyenv, virtualenv 등을 하나로 대체합니다.
curl -LsSf https://astral.sh/uv/install.sh | sh로 설치한 뒤uv init,uv add,uv remove,uv lock,uv venv,uv run으로 프로젝트를 관리할 수 있습니다.- 직접 테스트해 보니 기존 pip 방식보다 훨씬 빠르게 패키지를 설치하고 관리할 수 있었습니다.
테스트 환경 uv 0.8.4 (x86_64-unknown-linux-gnu), CPython 3.7.16
UV
UV 는 Rust로 작성된 Python 패키지 및 프로젝트 관리자로 pip 의 대안으로 떠오르는 패키지 관리자입니다.
Highlights
🚀 pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv 등을 대체하는 단일 도구입니다.
⚡️ pip보다 10-100배 빠릅니다.
🗂️ 범용 잠금 파일을 통한 포괄적인 프로젝트 관리를 제공합니다.
❇️ 인라인 의존성 메타데이터를 지원하여 스크립트를 실행합니다.
🐍 Python 버전을 설치하고 관리합니다.
🛠️ Python 패키지로 게시된 도구를 실행하고 설치합니다.
🔩 친숙한 CLI로 성능 향상을 위한 pip 호환 인터페이스를 포함합니다.
🏢 확장 가능한 프로젝트를 위한 Cargo 스타일 워크스페이스를 지원합니다.
💾 의존성 중복 제거를 위한 글로벌 캐시로 디스크 공간을 효율적으로 사용합니다.
⏬ curl 또는 pip을 통해 Rust나 Python 없이도 설치 가능합니다.
🖥️ macOS, Linux, Windows를 지원합니다.
Installation
/> # python --version
Python 2.7.18 <<<---- 운영체제 Python 버전
/> # curl -LsSf https://astral.sh/uv/install.sh | sh
downloading uv 0.8.4 x86_64-unknown-linux-gnu
no checksums to verify
installing to /root/.local/bin
uv
uvx
everything's installed!
To add $HOME/.local/bin to your PATH, either restart your shell or run:
source $HOME/.local/bin/env (sh, bash, zsh)
source $HOME/.local/bin/env.fish (fish)
How to
프로젝트 초기화
/> # uv init uv-test
Initialized project `uv-test` at `/root/uv-test`
/> # cd uv-test; tree -a
.
├── main.py
├── pyproject.toml <<--- 프로젝트의 메타데이터와 설정을 저장하는 파일
├── .python-version <<--- 프로젝트에서 사용할 Python 버전을 지정하는 파일
└── README.md
의존성 패키지 추가
/> uv add flask
Using CPython 3.7.16 interpreter at: /usr/bin/python3.7
Creating virtual environment at: .venv
Resolved 24 packages in 115ms
Prepared 9 packages in 53ms
Installed 9 packages in 15ms
+ click==8.1.8
+ flask==2.2.5
+ importlib-metadata==6.7.0
+ itsdangerous==2.1.2
+ jinja2==3.1.6
+ markupsafe==2.1.5
+ typing-extensions==4.7.1
+ werkzeug==2.2.3
+ zipp==3.15.0
/> # cat uv.lock
version = 1
revision = 3
requires-python = ">=3.7"
resolution-markers = [
"python_full_version >= '3.10'",
"python_full_version == '3.9.*'",
"python_full_version == '3.8.*'",
"python_full_version < '3.8'",
]
... skip
/> # uv pip freeze > requirements.txt
/> # cat requirements.txt
click==8.1.8
flask==2.2.5
importlib-metadata==6.7.0
itsdangerous==2.1.2
jinja2==3.1.6
markupsafe==2.1.5
typing-extensions==4.7.1
werkzeug==2.2.3
zipp==3.15.0
의존성 패키지 제거
/> # uv add flask_cors
Resolved 26 packages in 42ms
Prepared 1 package in 11ms
Installed 1 package in 1ms
+ flask-cors==5.0.0
/> # uv remove flask-cors
Resolved 24 packages in 41ms
Uninstalled 1 package in 0.40ms
- flask-cors==5.0.0
/> # uv pip freeze > requirements.txt
/> # cat requirements.txt
click==8.1.8
flask==2.2.5
importlib-metadata==6.7.0
itsdangerous==2.1.2
jinja2==3.1.6
markupsafe==2.1.5
typing-extensions==4.7.1
werkzeug==2.2.3
zipp==3.15.0
패키지 버전 고정
/> # uv lock
Resolved 24 packages in 0.80ms
가상 환경 생성
/> # uv venv
Using CPython 3.7.16 interpreter at: /usr/bin/python3.7
Creating virtual environment at: .venv
✔ A virtual environment already exists at `.venv`. Do you want to replace it? · yes
Activate with: source .venv/bin/activate
UV 프로젝트로 실행
/> # uv run main.py
Installed 9 packages in 16ms
Flask 버전: 2.2.5
Python 버전: 3.7.16 (default, Jun 27 2025, 23:12:33)
...
테스트 결과 :
$ curl -s 172.31.46.51:5000 | egrep "\"version-l|\"version-v"
<div class="version-label">Flask Version:</div>
<div class="version-value">2.2.5</div>
<div class="version-label">Python Version:</div>
<div class="version-value">3.7.16 (default, Jun 27 2025, 23:12:33)
프로젝트 이외 경로에서 실행 방안
/> # uv run --project /root/uv-test /root/uv-test/main.py
pip 과 비교
기존 pip 을 통해 패키지를 설치하고 관리하는 방법에 비해 매우 빠른 성능으로 패키지를 설치 관리 할 수 있었습니다.
실제 대규모 프로젝트에서는 많은 의존성으로 인해 빌드 과정이 복잡해질 것이며, UV 를 사용하게되면 성능적 (속도)으로 효과적인 개선 효과를 만들 수 있을 것으로 기대합니다.
참고 자료
자주 묻는 질문
uv는 어떻게 설치하나요?
curl -LsSf https://astral.sh/uv/install.sh | sh로 설치합니다. 설치 후 uv, uvx가 $HOME/.local/bin에 위치하며, 셸을 재시작하거나 source $HOME/.local/bin/env를 실행해 PATH에 추가합니다.
uv에서 패키지 의존성을 추가하고 제거하려면 어떻게 하나요?
uv add flask처럼 추가하고 uv remove flask-cors처럼 제거합니다. 추가 시 가상 환경 .venv가 없으면 자동으로 생성되고 uv.lock에 버전이 기록됩니다.
uv 프로젝트에서 requirements.txt를 만들 수 있나요?
네. uv pip freeze > requirements.txt로 현재 설치된 패키지 목록을 requirements.txt로 저장할 수 있습니다.
프로젝트 디렉터리 밖에서 uv 프로젝트를 실행하려면 어떻게 하나요?
uv run --project /root/uv-test /root/uv-test/main.py처럼 --project 옵션으로 프로젝트 경로를 지정해 실행합니다.