uv
<a href="https://pypi.python.org/pypi/uv"><img src="https://img.shields.io/pypi/v/uv.svg" alt="Latest PyPI version" /></a>
<a href="https://pypi.python.org/pypi/uv"><img src="https://img.shields.io/pypi/pyversions/uv.svg" alt="Supported Python versions" /></a>
<a href="https://discord.gg/astral-sh"><img src="https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white" alt="Discord" /></a>
Rust로 작성된 매우 빠른 Python 패키지 및 프로젝트 관리자입니다.
<p align="center">
<picture align="center">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/astral-sh/uv/assets/1309177/03aa9163-1c79-4a87-a31d-7a9311ed9310">
<source media="(prefers-color-scheme: light)" srcset="https://github.com/astral-sh/uv/assets/1309177/629e59c0-9c6e-4013-9ad4-adb2bcf5080d">
<img alt="Shows a bar chart with benchmark results." src="https://github.com/astral-sh/uv/assets/1309177/629e59c0-9c6e-4013-9ad4-adb2bcf5080d">
</picture>
</p>
<p align="center">
<i>따뜻한 캐시를 사용하여 <a href="https://trio.readthedocs.io/">Trio</a>의 의존성을 설치합니다.</i>
</p>
주요 특징
pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv 등을 대체하는 단일 도구입니다.
pip보다 10~100배 빠릅니다.
- 포괄적인 프로젝트 관리를 제공하며, 범용 락파일(universal lockfile)을 사용합니다.
- 스크립트 실행 기능을 제공하며, 인라인 의존성 메타데이터(inline dependency metadata)를 지원합니다.
- Python 버전을 설치하고 관리합니다.Python versions.
- 파이썬 패키지로 배포되는 도구를 실행하고 관리합니다.Tools.
- 친숙한 CLI(Command Line Interface)를 통해 성능 향상을 제공하는 pip 호환 인터페이스(pip-compatible interface)를 포함합니다.
- 확장 가능한 프로젝트를 위해 Cargo 스타일의 워크스페이스(workspaces)를 지원합니다.
- 의존성 중복 제거를 위한 글로벌 캐시(global cache)를 통해 디스크 공간 효율성을 높였습니다.
- Rust나 Python 없이
curl 또는 pip을 통해 설치할 수 있습니다.
- macOS, Linux, Windows를 지원합니다.
uv는 Ruff와 ty의 개발사인 Astral에서 지원합니다.
설치 (Installation)
독립 실행형 설치 프로그램으로 uv를 설치하세요:
curl -LsSf https://astral.sh/uv/install.sh | sh
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
또는 PyPI에서 설치할 수 있습니다:
독립 실행형 설치 프로그램으로 설치한 경우, uv는 최신 버전으로 자체 업데이트할 수 있습니다:
자세한 내용 및 대체 설치 방법은 설치 문서(installation documentation)를 참조하세요.
문서화 (Documentation)
uv의 문서는 docs.astral.sh/uv에서 확인할 수 있습니다.
또한, 명령줄 참조 문서는 uv help로 확인할 수 있습니다.
기능(Features)
프로젝트(Projects)
uv는 락파일(lockfile), 워크스페이스(workspace) 등을 지원하며 프로젝트 종속성 및 환경을 관리합니다. 이는 rye나 poetry와 유사합니다:
$ uv init example
Initialized project `example` at `/home/user/example`
...
시작하려면 프로젝트 문서를 참조하세요.
uv는 또한 프로젝트가 uv로 관리되지 않더라도 빌드 및 게시(publishing)를 지원합니다. 더 자세한 내용은 게시 가이드를 참조하세요.
스크립트(Scripts)
uv는 단일 파일 스크립트에 대한 종속성 및 환경을 관리합니다.
새 스크립트를 생성하고 인라인 메타데이터를 추가하여 종속성을 선언하세요:
$ echo 'import requests; print(requests.get("https://astral.sh"))' > example.py
$ uv add --script example.py requests
...
그런 다음, 격리된 가상 환경에서 스크립트를 실행합니다:
$ uv run example.py
Reading inline script metadata from: example.py
Installed 5 packages in 12ms
...
시작하려면 스크립트 문서를 참조하세요.
uv는 pipx와 유사하게 Python 패키지에서 제공하는 명령줄 도구를 실행하고 설치합니다.
uvx(uv tool run의 별칭)를 사용하여 임시 환경(ephemeral environment)에서 도구를 실행합니다:
$ uvx pycowsay 'hello world!'
Resolved 1 package in 167ms
Installed 1 package in 9ms
...
uv tool install로 도구를 설치합니다:
$ uv tool install ruff
Resolved 1 package in 6ms
Installed 1 package in 2ms
...
시작하려면 도구 문서를 참조하세요.
Python 버전(Python versions)
uv는 Python을 설치하고 여러 버전 간의 빠른 전환을 가능하게 합니다.
여러 Python 버전 설치하기:
$ uv python install 3.12 3.13 3.14
Installed 3 versions in 972ms
+ cpython-3.12.12-macos-aarch64-none (python3.12)
...
필요한 경우 Python 버전을 다운로드합니다:
$ uv venv --python 3.12.0
파이썬 3.12.0 사용 중
가상 환경을 .venv에 생성합니다
...
현재 디렉터리에서 특정 Python 버전을 사용하려면:
$ uv python pin 3.11
.python-version 파일을 `3.11`로 고정했습니다
시작하려면 Python 설치 문서를 참조하세요.
pip 인터페이스
uv는 일반적인 pip, pip-tools, 및 virtualenv 명령어에 대한 드롭인 대체재(drop-in replacement)를 제공합니다.
uv는 종속성 버전 재정의(dependency version overrides), 플랫폼 독립적 해결(platform-independent resolutions), 재생 가능한 해결(reproducible resolutions), 대안적인 해결 전략 등 고급 기능을 추가하여 인터페이스를 확장했습니다.
기존 워크플로우를 변경하지 않고 uv로 마이그레이션하고 uv pip 인터페이스를 통해 10~100배의 속도 향상을 경험해 보세요.
요구사항을 플랫폼 독립적인 요구사항 파일로 컴파일하세요:
$ uv pip compile requirements.in \
--universal \
--output-file requirements.txt
...
가상 환경을 생성하세요:
$ uv venv
파이썬 3.12.3 사용 중
가상 환경을 .venv에 생성합니다
...
고정된 요구사항을 설치하세요:
$ uv pip sync requirements.txt
43개 패키지를 11ms 만에 해결했습니다
43개 패키지를 208ms 만에 설치했습니다
...
시작하려면 pip 인터페이스 문서를 참조하세요.
기여 (Contributing)
저희는 모든 수준의 경험을 가진 기여자들을 지원하는 데 열정을 가지고 있으며, 여러분이 프로젝트에 참여하기를 바랍니다. 시작하려면 기여 가이드를 참조하세요.
FAQ
uv는 어떻게 발음하나요?
"유-비(you - vee)"로 발음합니다 (/juː viː/).
uv를 어떻게 스타일링해야 하나요?
그냥 "uv"입니다. 자세한 내용은 스타일 가이드를 참조하세요.
uv는 어떤 플랫폼을 지원하나요?
uv의 플랫폼 지원 문서를 참조하세요.
uv는 프로덕션 환경에 준비되었나요?
네, uv는 안정적이며 프로덕션 환경에서 널리 사용됩니다. 자세한 내용은 uv의 [버전 관리 정책 (versioning policy)] 문서를 참조하십시오.
감사의 글 (Acknowledgements)
uv의 의존성 해결사(dependency resolver)는 내부적으로 [PubGrub]을 사용합니다. 저희는 특히 [Jacob Finkelman]님과 같은 PubGrub 유지보수자들에게 지원에 감사드립니다.
uv의 Git 구현은 [Cargo]를 기반으로 합니다.
uv의 일부 최적화는 저희가 [pnpm], [Orogene], 그리고 [Bun]에서 본 훌륭한 작업들로부터 영감을 받았습니다. 또한, Nathaniel J. Smith의 [Posy]로부터 많은 것을 배웠으며 Windows 지원을 위해 그 [trampoline] 기능을 조정했습니다.
라이선스 (License)
uv는 다음 중 하나에 따라 라이선스가 부여됩니다:
선택에 맡깁니다.
달리 명시하지 않는 한, 아파치-2.0 라이선스에 정의된 방식으로 귀하가 uv 포함을 위해 의도적으로 제출한 모든 기여는 추가적인 약관이나 조건 없이 위와 같이 이중으로 라이선스가 부여됩니다.
<div align="center">
<a target="_blank" href="https://astral.sh" style="background:none">
<img src="https://raw.githubusercontent.com/astral-sh/uv/main/assets/svg/Astral.svg" alt="Made by Astral">
</a>
</div>