uv/uvx란 무엇이고 설치는?

 

UVX란? (ChatGPT)

UVX는 UV 도구의 별칭으로, Python 패키지에서 제공하는 명령줄 도구를 설치하지 않고 실행할 수 있게 해주는 커맨드라인 인터페이스입니다. UVX를 사용하면 도구의 종속성이 일시적인 가상 환경에 설치되어 프로젝트와 격리되어 실행됩니다. 이를 통해 필요할 때마다 도구를 쉽게 실행할 수 있으며, 실행 후에는 가상 환경이 자동으로 삭제되어 디스크 공간을 절약할 수 있습니다.

 

예를 들어, uvx pycowsay 'hello world!' 명령을 사용하면 pycowsay 도구를 일시적인 환경에 설치하고 실행하여, 사용자가 추가적인 설치 과정 없이 즉시 도구를 사용할 수 있게 합니다.

이와 같이 UVX는 특히 개발자들이 여러 다른 도구를 자주 사용하지만, 이들을 영구적으로 설치하고 싶지 않을 때 유용합니다.

또한, UVX는 uv tool install 명령어와 동일하게 사용될 수 있으며, 자주 사용하는 도구는 이 명령을 통해 지속적인 환경에 설치할 수도 있습니다. 이렇게 설치된 도구는 시스템의 PATH에 자동으로 추가되어, 어느 위치에서든 직접 호출할 수 있습니다.

UV 도구는 광범위한 프로젝트 관리 기능을 제공하며, 파이썬 패키지의 관리와 버전 관리를 위한 강력한 도구로 사용될 수 있습니다.

여기가 정리가 잘되어있네요.

 

설치방법

$ brew install uv

% uv --version
uv 0.6.5 (Homebrew 2025-03-06)

% uvx --version
uv-tool-uvx 0.6.5 (Homebrew 2025-03-06)

 

명령어

• 새로운 uv 프로젝트 초기화, pyproject.toml 생성

$ uv init

 

• 패키지 추가

$ uv add <패키지명>
$ uv add -r requirements.txt로 `requirements.txt` 전체 추가 가능

 

• 가상환경 재생성 및 동기화

# pyproject.toml 과 uv.lock 파일을 기준으로 가상환경 재생성 및 동기화
$ uv sync

 

• 파이썬 스크립트 실행

# 가상환경을 자동 적용하여 파이썬 스크립트 실행
$ uv run <파일명.py>

 

• uvx 명령어

# uvx <툴> (`uv tool run` 명령의 축약형)
# ruff, mypy 등 서드파티 명령을 자동으로 설치·실행해줌
$ uvx ruff check .

$ uvx create-mcp-server --path mcp-test-server