uv

macOS / Linux용 공식 원라인 설치 프로그램 — uv를 `~/.local/bin`에 설치하고 현재 셸의 PATH에 추가합니다.

관리되는 Python 설치에서 uv를 격리된 CLI 툴로 설치합니다(권장).

Windows Package Manager(Windows 10/11)를 통해 uv를 설치합니다.

uv를 최신 릴리스로 업데이트합니다. 다음 사전 릴리스를 받으려면 `--preview`을 사용하세요.

--preview; --stable

Python 인터프리터를 uv의 관리 캐시(`~/.cache/uv` / `%LOCALAPPDATA%\uv`)에 다운로드합니다. `3.12`, `3.11.9`, 또는 nightly용 `cpython-3.13.0a5`도 전달할 수 있습니다.

3.12; 3.11.9; [email protected]; --mirror

uv가 다운로드할 수 있는 모든 Python 인터프리터(CPython, PyPy, free-threaded 빌드)를 나열합니다. 이미 가진 것만 필터링하려면 `--only-installed`를 사용하세요.

--only-installed; --all-versions; --arch; --os

현재 디렉터리에서 uv가 사용할 인터프리터의 경로를 출력합니다. `.python-version`, `pyproject.toml`, 활성 virtualenv를 존중합니다.

<version>

현재 프로젝트의 Python 버전을 고정합니다 — `.python-version`을 작성합니다. CI / Docker는 이를 읽어 로컬 인터프리터와 일치시킬 수 있습니다.

새 Python 프로젝트를 스캐폴딩합니다: `pyproject.toml`, hello-world 모듈, `.gitignore`, 옵션으로 tests / README.

--package 배포 가능 패키지로 빌드; --lib 라이브러리로 빌드; --bare 소스 레이아웃 없음; --python <ver>; --no-readme; --no-pin-python

라이브러리 프로젝트를 초기화합니다(src 레이아웃, `from <name> import ...` 노출).

`pyproject.toml`과 `uv.lock`에 선언된 모든 의존성을 프로젝트 virtualenv에 설치합니다. 멱등이며, `--frozen`은 lockfile 업데이트를 건너뛰고, `--locked`는 변경 시 실패합니다.

--frozen; --locked; --no-dev; --extra <name>; --all-extras; --group <name>; --no-install-project

설치하지 않고 `uv.lock` 파일을 해석하고 작성합니다. `pyproject.toml`과 일치하는지 검증하려면 `--check`를 사용하세요(CI에서 유용).

--check; --upgrade; --upgrade-package <pkg>; --frozen; --dry-run

`pyproject.toml`에 의존성을 추가하고 `uv.lock`을 업데이트하며 venv에 설치합니다.

--dev; --group <name>; --optional <extra>; --upgrade; --<specifier>; --editable <path>; --raw; --no-sync; --python <ver>

버전 지정자(PEP 440)와 함께 의존성을 추가합니다. 셸에서 따옴표 사용을 권장합니다.

개발 전용 의존성을 추가합니다 — `pyproject.toml`의 `[dependency-groups].dev]`에 들어갑니다.

명명된 의존성 그룹에 추가합니다. 여러 그룹은 `uv sync --group docs --group lint`로 설치할 수 있습니다.

`pyproject.toml`, lockfile, venv에서 의존성을 제거합니다.

--dev; --group <name>; --optional <extra>

프로젝트 virtualenv에서 명령을 실행합니다. venv가 없으면 자동으로 다시 만듭니다.

--with <pkg> 임시 의존성 추가; --with-requirements <file>; --no-sync; --locked; --frozen; --isolated; --refresh-package <pkg>; --package <name>

프로젝트 venv에 설치된 툴을 실행합니다 — 먼저 venv를 활성화할 필요가 없습니다.

다음에 캐시될 일회성 의존성으로 임시 스크립트를 실행합니다.

PEP 723 인라인 메타데이터를 사용하는 Python 스크립트를 실행합니다(uv는 상단의 `# /// script` 블록을 읽고 즉시 해석합니다).

--no-sync

`.venv`에 프로젝트 virtualenv를 만듭니다. pip + setuptools를 함께 번들하려면 `--seed`를 사용하세요.

<path>; --python <ver>; --seed; --no-seed; --prompt <name>; --system-site-packages; --clear; --relocatable

venv를 만들고 pip / setuptools / wheel도 설치합니다 — venv 내부에서 `pip install` 워크플로우에 필요합니다.

프로젝트 venv와 lockfile을 삭제합니다. 처음부터 다시 시작하려면 `uv sync`와 함께 사용하세요.

임시 환경에서 CLI 툴을 실행합니다(`uv tool run`의 별칭). 첫 사용 후 캐시됩니다.

<tool>@<ver>; --from <pkg>; --with <dep>; --upgrade; --quiet

특정 패키지가 노출하는 툴을 실행합니다(패키지 이름과 CLI 이름이 다른 경우).

글로벌 CLI 툴을 격리된 환경에 설치합니다(pipx와 유사). 툴이 PATH에서 사용 가능해집니다.

--python <ver>; --with <dep>; --reinstall; --quiet; --force

`uv tool install`로 설치된 모든 CLI 툴을 나열합니다.

`uv tool install`로 설치된 CLI 툴을 제거합니다.

--quiet

설치된 모든 툴을 최신 버전으로 업그레이드합니다(`uv tool update-self`와 pin 파일 존중). 한 툴만 대상으로 하려면 이름을 전달하세요.

<tool>; --all; --reinstall; --quiet

uv의 모듈 캐시(`~/.cache/uv`)를 비웁니다. 전체 재다운로드를 강제하려면 `uv sync --refresh`와 함께 사용하세요.

<package>; --force

uv가 다운로드한 wheel에 사용하는 캐시 디렉터리를 출력합니다.

pip 호환 모드로 진입합니다 — 기존 프로젝트를 마이그레이션하거나 툴이 여전히 `pip`을 호출할 때 유용합니다.

<pkg>; -r <requirements.txt>; -e <path>; --index-url <url>

`requirements.in`을 고정된 `requirements.txt`로 해석합니다(`pip-tools`와 유사).

프로젝트의 소스 배포판과 wheel을 빌드합니다(`pyproject.toml`에 따라 hatchling / setuptools / poetry core 플러그인 사용).

-o <dir>; --wheel; --sdist; --no-byte-compile

빌드된 아티팩트를 PyPI(또는 `--index`를 통해 사용자 정의 인덱스)에 업로드합니다.

--token <pypi-token>; --index <name>; --publish-url <url>; --trusted-publishing <on|off>

uv 버전을 출력합니다.

모든 uv 하위 명령을 나열합니다.

한 하위 명령의 전체 플래그 목록을 출력합니다.