파이썬 3.10 가상환경 agentic 만들기
한 줄 요약
이 과정 전용 파이썬 방을 만듭니다. 이름은 agentic, 파이썬 버전은 3.10 으로 고정합니다. 명령 두 줄이면 끝납니다.
1. 명령 두 줄
터미널(Windows는 Anaconda Prompt)을 열고 아래를 차례로 칩니다.
터미널에서 실행 — 아직
(agentic)표시가 없어도 됩니다. 이 절에서 그 환경을 만듭니다.
# ① agentic 이라는 이름으로, 파이썬 3.10 짜리 방을 만든다
conda create -n agentic python=3.10 -y
# ② 만든 방으로 들어간다(활성화)
conda activate agentic
①은 처음 한 번만 하면 됩니다. 다운로드가 있어 1~3분 걸립니다.
②는 터미널을 새로 열 때마다 해 줘야 합니다.
명령 뜯어보기
| 조각 | 뜻 |
|---|---|
conda create |
새 가상환경을 만들어라 |
-n agentic |
이름(name)은 agentic |
python=3.10 |
그 방에 파이썬 3.10을 깔아라 |
-y |
중간에 "계속할까요?" 물으면 전부 yes |
2. 성공했는지 확인하는 법
conda activate agentic 이 성공하면 명령줄 맨 앞에 (agentic) 이 붙습니다.
(agentic) C:\Users\사용자명>
(agentic) mac@MacBook ~ %
이
(agentic)표시가 "지금 이 방 안에 있다"는 신호입니다. 앞으로 실습할 때마다 이 표시가 떠 있는지 먼저 확인하세요. 터미널을 새로 열면 표시가 사라지고(base)로 돌아갑니다. 그때마다conda activate agentic을 다시 치면 됩니다.
파이썬 버전도 확인해 둡니다.
터미널에서 실행 —
conda activate agentic을 마친 뒤. 명령줄 맨 앞에(agentic)표시가 있는지 먼저 확인하세요.(base)에서 치면 다른 버전이 나옵니다.
python --version
Python 3.10.20
뒷자리 숫자(.20)는 달라도 됩니다. 3.10 이면 맞습니다.
3. 왜 하필 3.10인가
파이썬은 3.12, 3.13까지 나와 있습니다. 그런데 이 과정에서는 3.10으로 고정합니다.
이유는 라이브러리 호환성 하나입니다. 이 과정에서 쓰는 langchain·langgraph·faiss 같은 라이브러리들은 서로 맞물려 돌아가는데, 너무 최신 파이썬에서는 아직 준비가 안 된 조합이 생깁니다. 3.10은 모든 라이브러리가 확실히 지원하는 버전입니다.
"내 컴퓨터에 이미 파이썬 3.12가 깔려 있는데요?" 상관없습니다. 그건 그대로 두고,
agentic방 안에만 3.10을 따로 넣는 것입니다. 서로 건드리지 않습니다. 이게 가상환경을 쓰는 이유입니다.
4. 앞으로 매번 하게 될 일
실습을 시작할 때마다 따를 순서입니다. 지금 외울 필요는 없고, 막힐 때 여기로 돌아오세요.
터미널에서 실행 — 아래 블록의 첫 명령이
conda activate agentic이므로, 아직(agentic)표시가 없어도 됩니다.
# 1) 터미널을 연다
# 2) 방에 들어간다
conda activate agentic
# 3) 프로젝트 폴더로 이동한다 (폴더는 다음 절에서 준비합니다)
cd ~/Documents/agentic_ai # macOS
cd %USERPROFILE%\Documents\agentic_ai # Windows
# 4) 실습 파일을 실행한다
python code/ch01_hello.py
자주 나는 문제
| 증상 | 원인 | 해결 |
|---|---|---|
CondaError: ... not found |
환경 이름 오타 | conda env list 로 목록 확인 |
(agentic) 이 안 붙는다 |
activate를 안 했거나 실패 | conda activate agentic 다시 실행 |
새 터미널을 열면 (base) 다 |
정상 동작 | 터미널마다 conda activate agentic |
| 방을 잘못 만들어 지우고 싶다 | — | conda env remove -n agentic 후 다시 생성 |
만든 방 목록은 이렇게 봅니다.
터미널에서 실행 —
(agentic)안이든(base)든 상관없습니다. 환경 목록은 어디서든 보입니다.
conda env list
# conda environments:
#
base /Users/mac/miniconda3
agentic * /Users/mac/miniconda3/envs/agentic
* 표시가 지금 들어와 있는 방입니다.
핵심 정리
conda create -n agentic python=3.10 -y— 방 만들기. 딱 한 번.conda activate agentic— 방에 들어가기. 터미널 열 때마다.- 성공 신호는 명령줄 맨 앞의
(agentic)표시입니다. - 파이썬은 3.10 으로 고정합니다. 라이브러리 호환성 때문입니다.
- 다음 절에서 VS Code를 설치하고 실습 폴더를 엽니다.