[Cursor] Python 프로젝트 생성, 삭제 및 uv로 패키지 설치까지

최근 Python 개발에서는 uv 와 Cursor 조합이 매우 많이 사용되고 있습니다.
기존 pip + venv 조합보다 훨씬 빠르고 관리가 편하기 때문입니다.

이번 글에서는 다음 과정을 처음부터 끝까지 정리해보겠습니다.

• Cursor에서 새 프로젝트 생성
• uv 기반 Python 프로젝트 초기화
• .venv 가상환경 생성
• 패키지 설치
• 가상환경 활성화/비활성화
• 프로젝트 삭제

1. 새 프로젝트 폴더 생성

1. 먼저 원하는 위치에 프로젝트 폴더를 생성합니다.

C:\MyProject\LLM\crewai

 

 

2. Cursor 를 실행하고 위의 생성한 폴더를 엽니다. 프로젝트 폴더를 열면 Cursor 좌측 Explorer에서 현재 프로젝트 구조를 볼 수 있습니다.

 

3. 커서에서 터미널을 실행합니다. 터미널이 열리면 현재 위치가 프로젝트 폴더인지 확인하세요.

Terminal → New Terminal

 

또는 단축키:

Ctrl + `

 

 

4. 이제 uv 기반 프로젝트로 초기화합니다.

uv init

 

실행하면 다음과 같은 파일들이 생성됩니다.

crewai/
├── pyproject.toml
├── README.md
└── .python-version

 

여기서 핵심은 pyproject.toml 인데, 다음을 관리합니다.

• 프로젝트 정보
• 의존성(package)
• Python 버전

5. 프로젝

트 전용 가상환경을 생성합니다.

uv venv

 

실행 후,  .venv 폴더가 생성됩니다. 

crewai/
├── .venv/
├── pyproject.toml
└── README.md

 

.venv 안에는:

• Python 실행 파일
• 설치된 패키지
• 가상환경 설정

이 저장됩니다.

 

6. 가상환경을 활성화하세요.

PowerShell 기준: 커서 터미널에서 다음을 실행합니다.

.\.venv\Scripts\Activate.ps1

 

성공하면 프롬프트 앞에:

(.venv)

 

가 표시됩니다. 이 상태에서 설치되는 패키지는 현재 프로젝트에만 적용됩니다.

 

7. 원하는 패키지를 설치합니다. 저는 CrewAI 를 설치합니다.

uv add crewai

 

설치 후:

• pyproject.toml
• uv.lock

파일이 자동 갱신됩니다.

 

8. 설치된 패키지를 확인하세요. 

uv pip show crewai

 

예시 출력:

Name: crewai
Version: 1.14.4
Location: ...\.venv\Lib\site-packages

 

 

9. 현재 활성화된 환경 확인하려면:

echo $env:VIRTUAL_ENV

 

출력 예:

C:\MyProject\LLM\3_mycrew\.venv

 

 

10. 작업이 끝났다면 가상환경을 비활성화하세요. 

deactivate

 

그러면 다음 표시가 사라집니다.

(.venv)

 

11. 프로젝트를 삭제할 필요가 있다면, 그냥 해당 프로젝트 폴더 삭제합니다

.

 

추천 프로젝트 구조

Python 프로젝트는 보통 아래처럼 관리합니다.

LLM/
├── project_a/
│   ├── .venv/
│   └── pyproject.toml
│
├── project_b/
│   ├── .venv/
│   └── pyproject.toml
│
└── project_c/
    ├── .venv/
    └── pyproject.toml

 

프로젝트별 .venv 를 두면:

• 패키지 충돌 방지
• Python 버전 분리
• 유지보수 편의성

측면에서 매우 유리합니다.