반응형
uv는 파이썬(Python) 개발 환경을 아주 빠르고 효율적으로 관리해 주는 차세대 패키지 매니저입니다. 쉽게 말해, 파이썬 설치, 라이브러리 설치, 가상환경 관리를 하나로 합친 '만능 도구'라고 생각하시면 됩니다.
1. uv가 정확히 무엇인가요?
기존의 파이썬 개발 방식은 pip, venv, conda, pyenv 등 여러 도구를 섞어서 써야 했고, 속도도 느렸습니다. 하지만 uv는 다음과 같은 장점이 있습니다:
- 엄청나게 빠름: 기존 pip보다 약 10~100배 정도 빠릅니다 (Rust 언어로 제작됨).
- 올인원(All-in-one): 파이썬 버전 관리, 패키지 설치(pip 역할), 가상환경 생성을 이 도구 하나로 다 끝냅니다.
- 프로젝트 격리: 각 프로젝트마다 독립된 환경을 아주 쉽게 만들어줍니다.
2. uv는 어디에 위치해야 하나요?
사용자 질문의 의도가 **"설치 경로"**인지 **"실행 위치"**인지에 따라 답변이 달라집니다.
① 설치 경로 (컴퓨터 어디에 저장되나?)
uv는 보통 시스템 전체에서 사용할 수 있도록 사용자 폴더의 숨겨진 경로에 설치됩니다.
- Windows: %USERPROFILE%\.cargo\bin 또는 %LOCALAPPDATA%\uv 폴더 안
- 확인 방법: 터미널(PowerShell)에서 where uv라고 치면 설치된 경로가 나옵니다.
- 환경 변수(Path): 설치 과정에서 자동으로 등록되지만, 등록되지 않으면 uv 명령어를 인식하지 못합니다.
② 실행 위치 (어떤 폴더에서 명령어를 쳐야 하나?)
uv 명령어는 **프로젝트의 루트 폴더(최상위 폴더)**에서 실행하는 것이 기본입니다.
- 사용자의 경우: E:\sharAce\ACE-Step-1.5 폴더 안에서 uv add torchao 등을 입력해야 합니다.
- 이 폴더 안에 pyproject.toml이나 .venv 폴더가 생성되면서 해당 프로젝트 전용 환경이 구축됩니다.
시스템 경로에 등록하고 싶지 않을때는 그냥....
uv는 무설치 실행 파일(Standalone Binary) 형태로 제공되기 때문에, 말씀하신 대로 특정 폴더에 넣고 경로를 직접 지정해서 사용할 수 있습니다.
1. uv 다운로드 및 배치 (E:\Py\ 폴더)
직접 다운로드해서 배치하는 방법입니다.
- 다운로드: 아래 링크에서 윈도우용 파일을 받으세요. (보통 uv-x86_64-pc-windows-msvc.zip을 받으시면 됩니다.)
- 압축 풀기: 다운로드한 .zip 파일의 압축을 풀면 uv.exe 파일이 나옵니다.
- 이동: 이 uv.exe 파일을 E:\Py\uv.exe 경로가 되도록 옮겨주세요.
- (원하신다면 E:\Py\Python311\uv.exe에 넣으셔도 됩니다.)
2. 시스템 경로(Path) 추가 없이 사용하기
시스템 경로에 넣지 않았기 때문에, 그냥 uv라고 치면 작동하지 않습니다. 대신 전체 경로를 써주거나, 아까 만든 배치 파일을 수정해야 합니다.
방법 A: 터미널에서 직접 실행할 때
PowerShell
예를 들자면 이제.
E:\Py\uv add torchao 라고 실행 해야함.
반응형