🔥가상환경 uv

uv add 명령어는 pyproject.toml 파일이 있어야 작동합니다. 현재 디렉토리에 프로젝트가 초기화되지 않은 상태예요.

해결 방법:

# 1. uv 프로젝트 초기화 (pyproject.toml 생성)
uv init

# 2. 그 다음 패키지 추가
uv add django djangorestframework

또는 uv init 없이 바로 하려면:

# pip 방식으로 직접 설치
uv pip install django djangorestframework

---

두 방법의 차이:

방법	특징
uv init → uv add	pyproject.toml에 의존성 기록됨 (권장)
uv pip install	가상환경에만 설치, 기록 없음

Django 프로젝트를 제대로 관리하려면 uv init 후 uv add를 쓰는 게 좋습니다. 혹시 ~/HY_leverage 폴더가 이미 Django 프로젝트 구조라면 pyproject.toml만 없는 건지 확인해볼게요:

uv 가상환경 명령어

가상환경 생성

uv venv                    # 기본 (.venv 폴더에 생성)
uv venv myenv              # 이름 지정
uv venv --python 3.11      # Python 버전 지정
uv venv myenv --python 3.12

가상환경 활성화

# macOS / Linux
source .venv/bin/activate

# Windows (CMD)
.venv\Scripts\activate.bat

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

가상환경 비활성화

deactivate

패키지 관리

uv pip install pandas           # 패키지 설치
uv pip install -r requirements.txt  # requirements.txt로 설치
uv pip uninstall pandas         # 패키지 제거
uv pip list                     # 설치된 패키지 목록
uv pip freeze                   # requirements 형식으로 출력

가상환경 없이 바로 실행 (편리한 기능)

uv run python script.py         # 자동으로 venv 감지 후 실행
uv run --with pandas python script.py  # 특정 패키지와 함께 실행

프로젝트 초기화 (pyproject.toml 기반)

uv init myproject       # 새 프로젝트 생성
uv add pandas           # 의존성 추가
uv sync                 # 의존성 동기화

팁: uv는 pip보다 10~100배 빠르며, uv run을 사용하면 가상환경 활성화 없이도 바로 실행할 수 있어 편리합니다.

---

가상환경 안 vs 밖 설치 기준

✅ 가상환경 안에 설치 (프로젝트별 의존성)

프로젝트마다 버전이 다를 수 있는 것들

# 프레임워크 / 라이브러리
uv add fastapi django flask
uv add pandas numpy scikit-learn

# 개발 도구 (프로젝트 종속)
uv add --dev pytest black ruff mypy
uv add --dev ipykernel jupyter  # 이 프로젝트용 커널

기준: pyproject.toml 또는 requirements.txt에 기록되어야 할 것들

---

🌍 가상환경 밖에 설치 (글로벌)

어느 프로젝트에서나 동일하게 쓰는 도구들

# uv 자체
curl -LsSf https://astral.sh/uv/install.sh | sh

# Python 버전 관리
uv python install 3.11
uv python install 3.12

# 전역 CLI 도구
pipx install cookiecutter   # 프로젝트 템플릿
pipx install pre-commit     # git 훅 관리

기준: 특정 프로젝트가 아니라 개발 환경 자체에 필요한 것들

---

🤔 헷갈리는 것들

도구	권장 위치	이유
black, ruff	가상환경 안	프로젝트마다 버전 고정 필요
pytest	가상환경 안	테스트 대상 코드와 같은 환경 필요
jupyter	가상환경 안	커널이 프로젝트 패키지를 봐야 함
pre-commit	글로벌 (pipx)	여러 프로젝트 공통
git	글로벌 (시스템)	당연히 전역
uv, pyenv	글로벌 (시스템)	환경 관리 도구 자체

---

핵심 원칙

"이 패키지가 없으면 프로젝트가 안 돌아간다" → 가상환경 안
"개발 머신이면 항상 있어야 한다"           → 가상환경 밖 (글로벌)

---

uv add 명령어는 pyproject.toml 파일이 있어야 작동합니다. 현재 디렉토리에 프로젝트가 초기화되지 않은 상태예요.

해결 방법:

# 1. uv 프로젝트 초기화 (pyproject.toml 생성)
uv init

# 2. 그 다음 패키지 추가
uv add django djangorestframework

또는 uv init 없이 바로 하려면:

# pip 방식으로 직접 설치
uv pip install django djangorestframework

---

두 방법의 차이:

방법	특징
uv init → uv add	pyproject.toml에 의존성 기록됨 (권장)
uv pip install	가상환경에만 설치, 기록 없음

Django 프로젝트를 제대로 관리하려면 uv init 후 uv add를 쓰는 게 좋습니다. 혹시 ~/HY_leverage 폴더가 이미 Django 프로젝트 구조라면 pyproject.toml만 없는 건지 확인해볼게요:

ls ~/HY_leverage

결과를 보여주시면 상황에 맞게 안내해드릴게요!

script.py 파일이 존재하지 않아서 생기는 오류예요! 파일을 먼저 만들어야 합니다.

# script.py 파일 생성
touch script.py

# 또는 내용과 함께 바로 생성
echo "print('hello')" > script.py

# 그 다음 실행
uv run python script.py

혹시 파일 이름이 다른 거 아닐까요? 현재 폴더에 뭐가 있는지 확인해보세요:

ls ~/HY_leverage