Skip to main content
uv는 Python 설치와 가상환경 생성을 빠르게 처리하는 도구입니다.

​
사전 준비

  • Homebrew 설치 완료
  • 터미널 사용 가능 상태

​
설치 과정

1

uv 설치

아래 명령어를 실행합니다.
curl -LsSf https://astral.sh/uv/install.sh | sh
2

셸 설정 반영

설치 후 현재 셸 설정을 다시 불러옵니다.
source ~/.zshrc
3

Python 설치 및 가상환경 생성

예시로 Python 3.12와 테스트 가상환경을 만듭니다.
uv python install 3.12
mkdir -p ~/dev/uv-test
cd ~/dev/uv-test
uv venv
source .venv/bin/activate

​
설치 확인하기

uv --version
python --version
가상환경이 활성화된 상태에서 Python 버전이 출력되면 정상입니다.

​
문제 해결

  • uv: command not found: source ~/.zshrc를 다시 실행하거나 터미널을 재시작합니다.
  • 가상환경 활성화 실패: 현재 폴더에 .venv가 생성됐는지 확인합니다.

​
설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

​
관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: PyTorch (MPS)

다음 설치 단계를 이어서 진행합니다.