AI 파이썬 Lab · Windows 환경설정 가이드

🖥️ Windows 환경설정 완전 가이드

처음 시작하는 여러분을 위한 단계별 안내예요.
한 단계씩 따라하면 수업 준비가 완료됩니다. 막히면 ⑦ 에러 해결 섹션을 먼저 확인해보세요!

목차 — 순서대로 진행하세요
1 PowerShell(터미널) 여는 법 2 Python 설치 3 VS Code 설치 4 수업 폴더 만들고 VS Code로 열기 5 가상환경(venv) 만들고 켜기 6 패키지(pip) 설치 7 .env 파일 만들어 API 키 넣기 8 코드에서 API 키 불러오기 9 Streamlit 앱 실행하기 ⚠ 자주 나오는 에러 해결
1
PowerShell(터미널) 여는 법

터미널은 컴퓨터에게 명령어로 일을 시키는 창이에요. 수업에서 자주 쓰니까 여는 법을 꼭 기억하세요!

1
방법 A — 키보드로 빠르게 열기 (추천)
Windows 키 + R → powershell 입력 → 엔터
2
방법 B — 시작 메뉴에서 열기
시작 버튼 → PowerShell 검색 → 클릭
3
방법 C — VS Code 안에서 열기 (가장 편해요)
VS Code 메뉴 → 터미널 → 새 터미널 (단축키: Ctrl + `)
✅ 파란 창에 PS C:\Users\... 같은 글자가 보이면 터미널이 열린 거예요
2
Python 설치
1
python.org 접속
브라우저에서 python.org/downloads 주소를 입력하세요
2
노란 버튼 "Download Python 3.x.x" 클릭해서 설치 파일 받기
3
설치 시작 — 첫 화면에서 체크박스 필수!
설치 창 맨 아래에 있는 "Add Python to PATH" 체크박스를 반드시 체크하세요
⚠️ 이 체크박스를 빠뜨리면 터미널에서 python이 안 돼요!

만약 이미 설치했는데 체크를 안 했다면 → Python 제거 후 다시 설치하세요

4
"Install Now" 클릭 → 설치 완료
5
설치 확인 — 터미널을 완전히 닫고 다시 열어서
PowerShell
python --version
✅ Python 3.x.x 라고 출력되면 성공!
⚠️ 'python'이 인식되지 않는다면
  • python3 --version 또는 py --version 으로 시도
  • 터미널을 완전히 닫고 다시 열었는지 확인
  • 그래도 안 되면 → Python 제거 후 PATH 체크하고 재설치
3
VS Code 설치

VS Code는 코드를 쓰는 프로그램이에요. 수업에서 계속 쓸 거예요.

1
code.visualstudio.com 접속 → "Download for Windows" 클릭
2
설치 중에 이 두 가지 체크박스를 꼭 체크하세요
✔ "PATH에 추가"    ✔ "코드로 열기 추가"
3
VS Code 열고 Python 확장 설치
왼쪽 네모 4개 아이콘(확장) 클릭 → 검색창에 Python 입력 → Microsoft가 만든 것 → 설치
✅ VS Code 왼쪽 아래에 Python 버전이 표시되면 완료!
4
수업 폴더 만들고 VS Code로 열기

모든 수업 파일은 한 폴더 안에 모아두는 게 가장 편해요.

1
바탕화면에 폴더 만들기
바탕화면 빈 곳 우클릭 → 새로 만들기 → 폴더 → 이름: dlab-python
2
VS Code에서 폴더 열기
VS Code 메뉴 → 파일 → 폴더 열기 → 방금 만든 dlab-python 선택
3
터미널 열기
VS Code 메뉴 → 터미널 → 새 터미널 (Ctrl + `)
✅ 터미널 경로가 dlab-python 폴더를 가리키면 준비 완료
5
가상환경(venv) 만들고 켜기

가상환경은 수업 전용 작업 공간이에요. 한 번만 만들면 돼요.

1
가상환경 만들기 (처음 한 번만)
터미널
python -m venv venv
2
가상환경 켜기 (수업 시작할 때마다)
터미널 (PowerShell)
venv\Scripts\activate
✅ 터미널 앞에 (venv) 표시가 생기면 성공!
⚠️ "스크립트를 실행할 수 없습니다" 오류가 나면

PowerShell을 관리자 권한으로 열고 아래 명령어 한 번만 실행하세요

PowerShell (관리자)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

이후 다시 venv\Scripts\activate 입력하면 돼요

💡 매번 수업 시작할 때

1. VS Code에서 dlab-python 폴더 열기

2. 터미널 열기 (Ctrl + `)

3. venv\Scripts\activate 입력 → (venv) 확인 후 시작!

6
패키지(pip) 설치

반드시 (venv) 표시가 있는 상태에서 설치하세요. 한 번 설치하면 다음에 또 안 해도 돼요.

W01·W06·W07·W09·W10 (Streamlit)
pip install streamlit openai python-dotenv
W02 (데이터 수집·정제)
pip install pandas
W03 (데이터 시각화)
pip install matplotlib seaborn
W04 (API 매시업)
pip install requests openai python-dotenv
W05 (AI 에이전트)
pip install openai python-dotenv
⚠️ (venv) 없이 설치하면 나중에 "모듈을 찾을 수 없어요" 오류가 나요!

설치 전 터미널에 (venv)가 있는지 꼭 확인하세요

7
.env 파일 만들어 API 키 넣기

API 키는 AI를 쓸 수 있는 비밀번호예요. 코드에 직접 쓰면 안 되고, .env 파일에 따로 보관해요.

1
VS Code 탐색기에서 새 파일 만들기
왼쪽 파일 목록에서 빈 곳에 마우스 → 새 파일 아이콘 클릭 → 파일명: .env
⚠️ 파일 이름이 정확히 .env 여야 해요 (점으로 시작!)

파일 탐색기에서 만들면 .env. 처럼 점이 두 개가 될 수 있어요

안전하게 VS Code 터미널에서 만드는 걸 추천해요:

터미널
New-Item .env
2
.env 파일을 열고 아래 내용 입력
.env
OPENAI_API_KEY=선생님이_알려준_키를_여기에_붙여넣기
⚠️ 키 앞뒤에 따옴표나 공백이 있으면 안 돼요!

올바른 예: OPENAI_API_KEY=sk-abc123...

잘못된 예: OPENAI_API_KEY= sk-abc123... (공백 있음)

3
.env 파일이 깃헙에 올라가지 않도록 .gitignore 설정
같은 폴더에 .gitignore 파일을 만들고 아래 내용 입력
.gitignore
.env
venv/
__pycache__/
8
코드에서 API 키 불러오기

.env 파일에 저장한 키를 코드에서 쓰려면 아래처럼 파일 맨 위에 추가하세요.

app.py — 맨 위에 추가
from dotenv import load_dotenv
load_dotenv()   # .env 파일 읽기

from openai import OpenAI
client = OpenAI()   # 키는 자동으로 불러와요
💡 키가 잘 불러와지는지 확인하려면
터미널
import os
from dotenv import load_dotenv
load_dotenv()
print(os.getenv("OPENAI_API_KEY")[:8])  # 앞 8자만 출력

sk-abc12 처럼 키 앞부분이 보이면 성공!

9
Streamlit 앱 실행하기
1
(venv) 확인 후 터미널에 입력
터미널
streamlit run app.py
✅ 브라우저가 자동으로 열리면서 앱이 뜨면 성공!
⚠️ 브라우저가 안 열린다면

터미널에 뜨는 주소를 복사해서 브라우저에 붙여넣으세요

브라우저 주소창
http://localhost:8501
2
앱 종료할 때
터미널에서 Ctrl + C 를 누르면 앱이 꺼져요
⚠
자주 나오는 에러 해결
❌ ModuleNotFoundError: No module named 'streamlit'

(venv) 없이 설치했거나, 다른 터미널에서 실행 중이에요

해결
venv\Scripts\activate
pip install streamlit
❌ streamlit : 스크립트를 실행할 수 없습니다
PowerShell 관리자 권한
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
❌ python app.py 실행했는데 Streamlit 화면이 안 뜸

python app.py 가 아니라 streamlit run app.py 로 실행해야 해요

❌ FileNotFoundError: movies.csv

CSV 파일을 app.py와 같은 폴더에 넣으세요. 터미널에서 dir 로 확인 가능

❌ UnicodeDecodeError: 한글 깨짐
해결
df = pd.read_csv("파일.csv", encoding="utf-8-sig")
❌ matplotlib 한글 깨짐 (□□□□)
코드 맨 위에 추가
plt.rcParams["font.family"] = "Malgun Gothic"
plt.rcParams["axes.unicode_minus"] = False
❌ openai.AuthenticationError: API 키 오류

.env 파일 위치가 코드와 같은 폴더인지 확인하고, 키 앞뒤 공백을 없애세요