JupyterLab에서 venv를 이용한 독립 커널 생성

JupyterLab에서 작업할 때 프로젝트별로 서로 다른 패키지 의존성을 관리해야 하는 경우가 있습니다. 이러한 상황에서 Python의 가상환경(virtual environment)을 활용하여 독립된 커널을 생성하면 패키지 충돌 없이 안정적인 개발 환경을 구축할 수 있습니다.

전제 조건

• Python 3.6 이상이 설치되어 있어야 합니다.
• pip 패키지 관리자가 사용 가능해야 합니다.
• JupyterLab이 설치되어 있어야 합니다.

1. 가상환경 생성

원하는 디렉토리에서 다음 명령어를 실행하여 새로운 가상환경을 생성합니다:

 

bash

python -m venv myproject_env

여기서 myproject_env는 가상환경의 이름으로, 프로젝트에 맞게 변경할 수 있습니다.

2. 가상환경 활성화

생성된 가상환경을 활성화합니다:

source myproject_env/bin/activate

 

가상환경이 활성화되면 터미널 프롬프트 앞에 환경 이름이 표시됩니다.

3. 필수 패키지 설치

활성화된 가상환경에서 ipykernel 패키지를 설치합니다.

pip install ipykernel

 

프로젝트에 필요한 다른 패키지들도 함께 설치할 수 있습니다.

pip install pandas numpy matplotlib seaborn scikit-learn

4. 커널 등록

가상환경을 JupyterLab 커널로 등록합니다.

python -m ipykernel install --user --name myproject_env --display-name "My Project Environment"

 

명령어 옵션 설명

• --user: 현재 사용자에 대해서만 커널을 설치
• --name: 커널의 내부 식별자 (고유해야 함)
• --display-name: JupyterLab에서 표시될 커널 이름

5. JupyterLab에서 커널 확인

JupyterLab을 실행합니다.

 

jupyter lab

새 노트북을 생성할 때 또는 기존 노트북의 커널을 변경할 때 "My Project Environment"가 선택 가능한 커널 목록에 나타납니다.

커널 관리

설치된 커널 목록 확인

 

bash

jupyter kernelspec list

커널 제거

더 이상 필요하지 않은 커널을 제거하려면:

 

bash

jupyter kernelspec uninstall myproject_env

가상환경 비활성화

작업 완료 후 가상환경을 비활성화하려면:

 

bash

deactivate