이 시리즈는 화장품 추천 서비스를 처음부터 만든다. 그 전에 아무것도 없는 상태를 정리해둔다.

1. 터미널을 연다

터미널은 글자로 컴퓨터에 명령하는 창이다. 윈도우에서 여는 방법은 여럿인데, 하나만 알면 된다.

2. 파이썬이 있는지 본다

python --version

없으면 python.org 에서 받아 설치한다.

3. 🔴 파이썬이 여러 개일 수 있다

여기가 이 편에서 제일 중요한 대목이다.

where python

python -m pip --version

4. 작업 폴더를 만든다

바탕화면에 폴더를 하나 만든다. 이름은 ai-eng-svc 로 한다.

5. 첫 파일을 만들고 실행한다

편집기는 무엇이든 된다. VS Code 를 쓰면 터미널이 안에 붙어 있어 편하다 — code.visualstudio.com 에서 받는다. 메모장으로도 된다.

ai-eng-svc 폴더에 00_hello.py 를 만든다.

# 이 줄은 주석이다. # 뒤는 파이썬이 읽지 않는다 — 사람에게 하는 설명이다.
# 앞으로 나올 코드에는 주석이 많이 붙어 있으니 같이 읽으면 된다.

print("준비 끝")          # print 는 괄호 안의 것을 화면에 찍는다

version = 3.13          # = 는 "왼쪽에 오른쪽 값을 담는다" 는 뜻이다
print("버전", version)   # 담아둔 값을 꺼내 쓴다

터미널에서 실행한다.

python 00_hello.py

6. 도구를 깐다

이 시리즈에서 깔 것은 셋뿐이다. 지금 다 깔 필요는 없다 — 각 편에서 필요할 때 안내한다.

깔고 나서는 깔렸는지 확인하는 습관을 들인다.

python -m pip show sentence-transformers
python -m pip list

가상환경을 안 쓴다

7. 나중에 정리하는 법

전역에 깔았으니 어디에 쌓이는지만 알아두면 된다. 두 자리뿐이다.

이번 편에 나온 것

미션

# sys 는 파이썬 자기 자신에 대한 정보를 담고 있는 도구다.
# 파이썬에 기본으로 들어 있어 설치할 것이 없다
import sys

# 지금 이 코드를 돌리고 있는 파이썬 프로그램의 위치
print("지금 도는 파이썬:", sys.executable)

# 버전 정보. split()[0] 은 앞의 숫자 부분만 잘라낸 것이다
print("버전:", sys.version.split()[0])

# 도구를 찾아다니는 폴더 목록. 위에서부터 순서대로 뒤진다
print("도구를 찾는 자리:")
for path in sys.path:
    print("   ", path)

정리하면

준비만 했다. 파이썬을 확인하고, 폴더를 만들고, 파일 하나를 실행했다.

여기서 제일 중요한 명령은 pip 이 아니라 where python 이었다. 이 컴퓨터에서는 파이썬이 세 개 나왔다 — 예전에 깐 것, 최근에 깐 것, 스토어가 심어둔 가짜. 이런 상태에서 pip install 을 치면 어느 쪽에 깔릴지 알 수 없고, 나중에 「분명히 깔았는데 없다」로 돌아온다.

그래서 이 시리즈는 항상 python -m pip 라고 친다. 조금 길지만 실행할 파이썬과 설치할 파이썬이 반드시 같아진다.

그리고 가상환경을 안 쓰기로 했다. 받을 것이 1GB 가 넘어서 상자를 새로 만들 때마다 다시 받는 게 부담이기 때문이다. 대신 무엇이 어디에 쌓이는지 알고, 지울 수 있어야 한다 — 각 편 마지막에 그 정리를 넣어뒀다.

다음 편에서 데이터를 만난다. 고객 300명, 상품 200개, 구매와 후기 1,500건이 든 CSV 세 개를 데이터베이스에 넣고 SQL 로 꺼내본다. 아무것도 깔 필요가 없다 — 데이터베이스 도구는 파이썬에 이미 들어 있다.