[Python] Jupyter Notebook(Lab)에 가상환경 커널 추가 방법

본 포스팅에서는 주피터 노트북(또는 랩)에 가상환경 커널(Kernel)을 추가하는 방법에 대해 알아봅니다.

---

가상환경 모듈로는 파이썬에서 공식으로 권장하는 패키지 관리 툴인 pipenv를 사용하겠습니다. pipenv 개념, 설치 및 활용방법에 대한 자세한 내용은 이곳을 참고해 주세요. 

[Python] pipenv 등장배경, 설치, 패키지 관리 방법

pipenv가 설치되어 있지 않으신 분들을 위해 pipenv 설치부터 간략한 설명과 함께 주피터 노트북에 가상환경 커널을 추가하는 절차만 소개합니다.

Step 1. pipenv 설치

pip install pipenv

Step 2.  가상환경 생성

mkdir 가상환경이름 && cd 가상환경이름

생성할 가상환경 이름을 입력해 주세요.

pipenv --python 3.x

가상환경에서 사용할 파이썬 버전을 지정합니다. 로컬에 저장되어 있는 파이썬 버전 중에서 입력해 주세요. 설치가 되어 있지 않다면 이곳에서 설치해 주세요.

Step 3.  가상환경 활성화

pipenv shell

Step 4.  jupyter, ipykernel 설치

jupyter와 ipykernel을 각각 설치합니다.

pipenv install jupyter

pipenv install ipykernel

ipykernel 설치

Step 5.  가상환경 커널 추가

python -m ipykernel install --user --display-name [표시할 커널이름] --name [가상환경이름]

가상환경 추가 커널

 

Step 6.  주피터노트북(랩) 실행

1) 주피터 노트북 실행 시키는 경우

jupyter notebook

2) 주피터 랩 실행 시키는 경우

jupyter lab

Step 7.  커널 변경 메뉴 선택

주피터 노트북 파일 생성 후, 상단 메뉴 내 Kernel - Change Kernel 선택

주피터 랩 내 커널 변경 메뉴 선택

Step 8.  커널 선택

생성한 커널 선택

🔍 참고문헌

[1]  Python, Managing Application Dependencies, https://packaging.python.org/en/latest/tutorials/managing-dependencies/#managing-dependencies
[2] Hey Tech Tistory, [Python] pipenv 등장배경, 설치, 패키지 관리 방법, https://heytech.tistory.com/320?category=453614

Update Log

@2022-03-11

- ㄱㄸㄱ님께서 ipykernel 설치 시 표시할 커널 이름과 가상환경 이름을 설정하는 부분의 위치가 잘못되었다는 피드백을 주시어, 해당 사항을 반영하여 수정하였습니다.

---

오늘은 주피터 노트북(또는 랩)에 가상환경 커널(Kernel)을 추가하는 방법에 대해 알아봤습니다.

포스팅 내용에 오류가 있다면 아래에 👇👇👇 댓글 남겨주시면 감사드리겠습니다.
그럼 오늘도 즐겁고 건강한 하루 보내시길 바랍니다 :)
고맙습니다.