uv 환경 커널을 사용하여 Jupyter Notebook 설정 방법

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

Python 개발자 및 Jupyter Notebook 사용자

핵심 요약

• uv sync 명령어로 가상 환경 생성 후 ipykernel 설치
• 커널 등록 시 VIRTUAL_ENV 경로와 python 실행 파일 경로 확인 필수
• uv add 명령어로 라이브러리 추가 시 Jupyter Notebook에서 즉시 사용 가능

섹션별 세부 요약

1. 가상 환경 생성

• git clone 명령어로 my-python-repo 저장소 클론
• uv sync 명령어로 uv.lock 파일 기반의 가상 환경(.venv) 생성
• 생성된 .venv 디렉토리가 uv가 관리하는 환경

2. ipykernel 설치

• uv add --dev ipykernel 명령어로 Jupyter가 인식할 수 있는 커널 지원 라이브러리 설치

3. 커널 등록

• uv run ipython kernel install 명령어로 커널 등록 (예: Python3.13.2-my-python-repo-new-feature)
• --env VIRTUAL_ENV 옵션으로 .venv 경로 지정

4. 커널 검증

• jupyter kernelspec list 명령어로 등록된 커널 확인
• kernel.json 파일에서 argv와 VIRTUAL_ENV 경로가 .venv 디렉토리와 일치하는지 확인

5. 커널 삭제

• jupyter kernelspec uninstall 명령어로 기존 커널 제거

6. 라이브러리 추가

• 노트북 셀 내 !uv add requests 또는 터미널에서 uv add requests 명령어로 라이브러리 추가
• 추가된 라이브러리는 즉시 Jupyter Notebook에서 사용 가능

결론

• uv를 사용한 환경 관리는 재현성 향상 및 라이브러리 즉시 사용 가능성을 제공
• uv add와 uv sync 명령어를 활용해 Jupyter Notebook 내에서 효율적인 환경 관리 가능