본문으로 건너뛰기

uv 설치 (권장)

uv는 Rust로 작성된 매우 빠른 Python package 및 project manager입니다. pip, poetry, pyenv, virtualenv 등을 하나의 도구로 대체할 수 있습니다.

uv 주요 특징
  • 성능: pip보다 10-100배 빠름
  • 통합 도구: pip, poetry, pyenv, virtualenv 등을 하나로 통합
  • Python 버전 관리: 여러 Python 버전 설치 및 관리
  • Global caching: 의존성 중복 제거 및 디스크 효율성

uv 설치​

권장 방법 (Standalone installer):

# curl 사용
curl -LsSf https://astral.sh/uv/install.sh | sh

# 또는 wget 사용
wget -qO- https://astral.sh/uv/install.sh | sh

설치 후 shell을 재시작하거나 다음 명령어를 실행하세요:

source $HOME/.local/bin/env

설치 확인​

# uv 버전 확인
uv --version

uv 업데이트​

Standalone installer로 설치한 경우:

uv self update

Homebrew로 설치한 경우:

brew upgrade uv

Python 버전 관리​

uv는 Python 버전을 직접 관리할 수 있습니다. 별도의 pyenv 설치가 필요 없습니다.

Python 설치​

# Python 3.12 설치 (권장)
uv python install 3.12 --default

기타 설치 옵션:

uv python install        # 최신 버전
uv python install 3.11   # 특정 버전
uv python install 3.11 3.12 3.13  # 여러 버전 동시

가상 환경 관리​

# 1. 가상 환경 생성
uv venv

# 2. 활성화
source .venv/bin/activate

# 3. 비활성화
deactivate

기타 옵션:

uv venv --python 3.12  # 특정 Python 버전 사용
uv venv my-env         # 이름 지정

Package 관리​

uv는 pip 호환 인터페이스를 제공합니다. 사용법 예시:

# Package 설치 (예시)
uv pip install <package-name>
uv pip install <package-name>==<version>

# requirements.txt로 설치
uv pip install -r requirements.txt

# 그 외 pip 명령어 동일
uv pip list
uv pip uninstall <package-name>
uv pip freeze > requirements.txt

다음 단계​

uv 설치 후:

  1. 로컬 실험 환경 - MLflow 개발환경 설정
  2. 로컬에서 첫 학습 실행 - MNIST 예제로 전체 workflow 경험