2장. 개발 환경 구성과 LLM API 호출

가상환경과 라이브러리 설치

한 줄 요약

이 과정 전용 파이썬 방 myenv 를 만들고, 그 안에 requirements.txt의 라이브러리를 한 번에 설치합니다. 그리고 VS Code가 이 방의 파이썬을 쓰도록 지정합니다.

---

1. 가상환경 만들기

VS Code의 터미널에서 입력합니다.

$ conda create -n myenv python=3.11 -y

1~2분 걸립니다. 끝나면 방에 들어갑니다(이것을 활성화라고 합니다).

$ conda activate myenv

프롬프트 맨 앞이 (base)에서 (myenv) 로 바뀝니다.

(myenv) 사용자명@PC MINGW64 ~/Documents/haru-market

이 (myenv) 표시가 "지금 이 방 안에 있다" 는 신호입니다. 터미널을 새로 열면 사라지므로, 그때마다 conda activate myenv를 다시 실행합니다. 실습이 안 될 때 가장 먼저 볼 곳이 여기입니다.

확인합니다.

$ python --version

Python 3.11.15

3.11로 시작하면 됩니다.

왜 3.11인가. 이 과정에서 쓰는 LangChain, LangGraph, google-genai의 최신 버전은 파이썬 3.10 이상을 요구합니다. 그중 3.11은 데이터 처리 라이브러리 pandas의 최신 버전까지 함께 설치되는 버전이고, 이 교재의 모든 코드를 3.11에서 실행해 확인했습니다.

---

2. 라이브러리 설치

(myenv)가 켜져 있는지, 터미널 위치가 haru-market인지 확인하고 실행합니다.

$ pip install -r requirements.txt

-r은 "파일에 적힌 목록대로 설치하라"는 뜻입니다. 3~5분 걸립니다. 글자가 많이 지나가다가 Successfully installed ...로 끝나면 성공입니다.

설치되는 것들입니다. 지금 외울 필요는 없고, 각 장에서 쓸 때 다시 설명합니다.

설치를 확인합니다.

$ pip list | grep google-genai

google-genai              2.28.0

버전 숫자는 더 높아도 됩니다.

---

3. VS Code에 인터프리터 지정하기

VS Code가 myenv의 파이썬을 쓰도록 알려 줍니다.

1. Ctrl + Shift + P (macOS는 Cmd + Shift + P)
2. Python: Select Interpreter 입력 후 선택
3. 목록에서 Python 3.11.x ('myenv') 를 고릅니다.

VS Code 창 오른쪽 아래에 3.11.x ('myenv')가 표시되면 됩니다.

이걸 안 하면 편집기에서 import 줄마다 노란 밑줄이 그어지고, 실행 버튼이 엉뚱한 파이썬으로 실행합니다. 이 과정에서는 항상 터미널에서 python 파일이름.py로 실행하므로 실행 자체는 터미널의 (myenv)만 맞으면 됩니다.

---

4. 자주 쓰는 conda 명령

---

핵심 정리

• conda create -n myenv python=3.11 -y 로 전용 환경을 만들고, conda activate myenv 로 켭니다.
• 프롬프트 앞의 (myenv) 가 켜져 있다는 표시입니다.
• pip install -r requirements.txt 로 과정 전체의 라이브러리를 한 번에 설치합니다.
• VS Code에서 Python: Select Interpreter → myenv 를 지정합니다.