[Python] 🚀 uv로 프로젝트 & 패키지 관리 완벽 가이드

1curl -LsSf https://astral.sh/uv/install.sh | sh

1powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

1pip install uv

1uv --version

 1# 현재 디렉토리에 새로운 파이썬 프로젝트 환경을 초기화하는 기본적인 파일과 폴더 구조가 자동으로 생성
 2uv init
 3
 4# 기본 프로젝트 생성
 5uv init my-project
 6
 7# 설정 파일만 필요하다면
 8uv init --bare
 9
10# 특정 Python 버전으로 생성
11uv init my-project --python 3.11
12
13# 가상환경 없이 생성
14uv init my-project --no-venv

1my-project/
2├── pyproject.toml       # 프로젝트 메타데이터 및 의존성 정의
3├── .python-version      # 사용할 Python 버전 고정
4├── uv.lock              # 의존성 버전 잠금 파일 (자동 생성)
5├── .venv/               # 가상환경 디렉토리
6└── src/
7    └── main.py          # 기본 진입점

 1# 패키지 추가
 2uv add requests
 3
 4# 특정 버전 추가
 5uv add requests==2.31.0
 6
 7# 개발 의존성 추가
 8uv add --dev pytest
 9
10# 로컬 패키지 (editable 모드)
11uv add -e ./localpackage

1uv remove requests
2uv remove --dev pytest

1uv sync                 # 전체 설치
2uv sync --dev           # 개발 의존성 포함
3uv sync --no-dev        # 개발 의존성 제외

1uv lock
2uv lock --dev
3uv lock --no-dev

1uv pip install requests

1uv pip install "requests==2.31.0"
2uv pip install "requests>=2.31.0"
3uv pip install "requests<3.0.0"

1uv pip install --dev pytest
2uv pip install --dev black isort mypy

1uv pip uninstall requests
2uv pip uninstall -y requests

1uv pip install --upgrade requests
2uv pip install --upgrade pip

1uv pip search "data science"
2uv pip show requests
3uv pip list
4uv pip list outdated
5uv pip freeze               # 현재 환경의 의존성 requirements 형식으로 출력

1uv venv
2uv venv --python 3.11
3uv venv --name myenv
4uv venv --clear

1source .venv/bin/activate
2source myenv/bin/activate

1.venv\Scripts\activate
2myenv\Scripts\activate

1deactivate

1uv python install 3.11
2uv python install 3.11.0
3uv python install 3.11 --force

1uv python list
2uv python remove 3.11
3uv python pin 3.11

1uv run --python 3.11 script.py
2uv run --python 3.11 -m pytest

1uv run script.py
2uv run -m module

1uv run --with-deps script.py
2uv run --no-deps script.py

1uv run script.py --arg1 value1 --arg2 value2
2uv run -m pytest tests/ --verbose

1uv run --env VAR1=value1 --env VAR2=value2 script.py

1uv init data-science-project --python 3.11
2cd data-science-project
3uv add pandas numpy matplotlib scikit-learn
4uv add --dev jupyter notebook
5uv run jupyter notebook

1uv init web-api --python 3.11
2cd web-api
3uv add fastapi uvicorn sqlalchemy pydantic
4uv add --dev pytest black mypy
5uv run uvicorn src.main:app --reload

1uv init ml-project --python 3.11
2cd ml-project
3uv add torch torchvision transformers datasets
4uv add --dev jupyter wandb tensorboard
5uv run python src/train.py