Search

[01] 수업에 필요한 프로그램 설치 및 가상화 환경 설정

생성일
2026/10/06 03:44
태그

📌 수업자료

1. 파이션 프로그램 설치 (Python 3.13.12)

2. VSCode 설치

3. VSCode 확장팩설치

4. 설치확인 : 명령 프롬프트를 실행해서 확인

5. AWS CLI 설치

6. Node.JS 설치

7. 모든 패키지(라이브러리) 설치확인 : 명령 프롬프트(관리자)를 실행해서 확인

1번.
C:\Users\HPE> python --version Python 3.13.15
JavaScript
복사
2번.
C:\Users\HPE> pip --version pip 26.2.1 from C:\Users\HPE\AppData\Local\Programs\Python\Python313\Lib\site-packages\pip (python 3.13)
JavaScript
복사
3번.
C:\Users\HPE> node --version v24.21.0
JavaScript
복사
4번.
C:\Users\HPE> npm --version 11.19.0
JavaScript
복사
•
npm은 Node.js에서 JavaScript 패키지를 설치하고 관리하는 도구로써, 쉽게 비교하면 Python 의 pip와 거의 같은 역할

8. 가상화 환경 설정 및 의존성 파일 설치

1.
작업 폴더 생성 : 2일간 작업할 작업 폴더 생성
mkdir c:\awsbedrock
JavaScript
복사
cd c:\awsbedrock
JavaScript
복사
2.
가상화 환경 생성 및 활성화 ( 본 수업에서는 가상환경을 파이션 3.13 버전으로 진행한다.)
python -m venv .venv
JavaScript
복사
py -3.13 -m venv .venv
JavaScript
복사
python.exe -m pip install --upgrade pip
JavaScript
복사
3.
가상화 환경 생성 및 활성화 확인
dir .venv\Scripts
JavaScript
복사
dir .venv\Scripts\activate
JavaScript
복사
4.
가상화 환경 생성 및 활성화
.venv\Scripts\activate
JavaScript
복사
deactivate
JavaScript
복사
•
의존 파일 설치 → 배포 환경에서 pip install -r requriements.txt 명령으로 패키지 설치 가능
pip install -r requriements.txt
JavaScript
복사
•
의존 파일 저장 → 다른 PC에 패키지(라이브러리) 설치를 좀더 쉽게 하기 위해 현재 설치 환경 저장
5번.
pip freeze > requirements.txt
JavaScript
복사
•
python -m venv .venv 가상환경을 만드는 명령어이고, 비활성화 명령어는 deactivate입니다
•
py -3.13 -m venv .venv 가상환경을 만드는 명령어이고, 비활성화 명령어는 deactivate입니다
5.
python -m venv .venv & py -3.13 -m venv .venv 차이점
두 명령어 모 .venv라는 Python 가상환경을 만드는 명령어입니다. 가장 중요한 차이는 어떤 Python 버전으로 가상환경을 만들지 선택하는 방법입니다.

핵심 차이

명령어
의미
Python 버전
python -m venv .venv
현재 python 명령어가 가리키는 Python 사용
현재 연결된 버전 사용
py -3.13 -m venv .venv
Windows Python Launcher로 3.13을 지정
무조건 Python 3.13
•
예를 들어 PC에 Python 3.11, 3.13, 3.14가 모두 설치되어 있다고 해보겠습니다.
python --version
Plain Text
복사
결과가
Python 3.14.6
Plain Text
복사
이라면,
python -m venv .venv
Plain Text
복사
만든 .venv는 Python 3.14.6 가상화 환경입니다.
반면,
py -3.13 -m venv .venv
Plain Text
복사
라고 하면 현재 기본 Python이 3.14여도 Python 3.13 가상화 환경을 만듭니다.
•
python과 py의 차이
python은 현재 PATH나 활성화된 환경에서 Python을 찾아 실행합니다.
python --version python -m pip --version python -m venv .venv
Plain Text
복사
•
반면 Windows의 py는 Python Launcher로, 여러 Python 버전 중 원하는 버전을 골라 실행하기 때문에 편리함.
py -3.11 --version py -3.13 --version py -3.14 --version
Plain Text
복사
•
설치되어 있는 Python 버전을 확인하려면 이것도 유용합니다.
py --list
Plain Text
복사
•
예를 들어:
-V:3.14 * Python 3.14 -V:3.13 Python 3.13 -V:3.11 Python 3.11
Plain Text
복사
•
여기서 *는 기본 버전을 의미합니다.

앞으로 우리가 수업중에 만들 PetStoreProject 를 예로 들면

Python 3.13을 사용하기로 정했다면 다음처럼 만드는 방법이 더 확실합니다.
cd C:\PetStoreProject py -3.13 -m venv .venv
Plain Text
복사
•
그다음 활성화합니다.
.\.venv\Scripts\Activate.ps1
Plain Text
복사
•
확인:
python --version
Plain Text
복사
•
결과:
Python 3.13.x
Plain Text
복사
•
그리고 패키지는 이렇게 설치합니다.
python -m pip install --upgrade pip python -m pip install boto3
Plain Text
복사
•
중요한 점은 가상화 환경을 활성화한 이후에는 굳이 py -3.13을 계속 사용할 필요가 없다는 것입니다. 활성화된 .venv의 python을 사용하면 됩니다.
py -3.13 -m venv .venv ↓ Python 3.13 기반 .venv 생성 ↓ .\.venv\Scripts\Activate.ps1 ↓ (.venv) 표시 ↓ python --version ↓ Python 3.13.x ↓ python -m pip install ...
Plain Text
복사
•
따라서 여러 Python 버전이 설치된 Windows PC에서는 처음 가상환경을 만들 때 py -3.13 -m venv .venv처럼 버전을 명시하는 방법을 추천
•
특히 AWS AgentCore 같은 프로젝트에서는 Python 버전 호환성이 중요해서 이 방법이 더 안전
5.
가상환경이 활성화된 상태에서 필요한 패키지 설치
python -m pip install --upgrade pip
JavaScript
복사
•
현재 사용 중인 Python 환경의 pip를 최신 버전으로 업그레이드하는 명령
python -m pip install streamlit boto3 pillow
JavaScript
복사
•
Python으로 AWS Bedrock + Streamlit 웹 애플리케이션을 만들 때 필요한 3개 패키지를 한꺼번에 설치하는 명령
패키지
역할
주로 사용하는 코드
streamlit
Python으로 웹 화면/UI 제작
import streamlit as st
boto3
Python에서 AWS 서비스 호출
import boto3
pillow
이미지 읽기·변환·처리
from PIL import Image
•
다시한번 설치 패키지를 정리하면
작업
PowerShell 명령어
가상환경 생성
py -3.13 -m venv .venv
가상환경 활성화
.\.venv\Scripts\Activate
가상환경 비활성화
deactivate
Python 버전 확인
python --version
pip install boto3 python-dotenv
JavaScript
복사
•
AWS를 Python에서 사용하기 위한 boto3와 .env 환경변수 파일을 읽기 위한 python-dotenv를 설치
•
아래 명령어는 requirements.txt 파일에 적혀 있는 Python 패키지를 한꺼번에 설치하라는 명령
python -m pip install -r requirements.txt
JavaScript
복사
•
현재 가상환경에 설치된 패키지를 버전까지 포함하여 requirements.txt에 저장
pip freeze > requirements.txt
JavaScript
복사
pip list
JavaScript
복사
•
현재 awsbedrock 폴더에서 아래와 같이 실행하면 VSCode 가 열리게 된다.
code .
JavaScript
복사