[ 트러블슈팅 ] Windows + uv + PyGWalker + Jupyter Lab

 

 

Jupyter Lab에서 이 화면을 띄워보려고 했던 삽질과 해결법을 정리 해둔다.

---

사전 설치

1. uv

프로젝트 관리를 굳이 uv로 하고싶었기 때문에 uv가 필요하다.

# uv 설치 명령어 (윈도우 기준)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

 

2. Python 3.10

distutils 패키지를 PyGWalker에서 활용하는데 3.11 버전 이후로는 없어져서 따로 설치도 불가능한 패키지이기 때문에 3.10 버전이 필요하다.

Python Release Python 3.10.0

위 링크로 설치하고 C:\Users\{유저명}\AppData\Local\Programs\Python\Python310\python.exe 경로에 잘 설치되었는지 확인한다.

경로가 다르면 그 경로를 기억 해둔다.

 

3. Visual Studio Build Tools

처음으로 uv add pygwalker 또는 uv pip install pygwalker 명령어를 내려보면 다음과 같은 오류를 처음 만나게 된다.

 

요구하는 대로 설치하려면 6GB 정도의 저장공간이 필요하다.

아래 블로그에 보면 몇GB 아낄 수 있는 방법을 안내하는데 내가 해보지는 않아서 되는지 모르겠다.

오류-python | error: Microsoft Visual C++ required 오류 해결 방법 [error: Microsoft Visual C++ OO.O or greater is requi

 

내가 한 방법은 다음과 같다.

아래 링크에서 빌드 툴을 설치한다.

Microsoft C++ Build Tools - Visual Studio

 

인스톨러를 설치했다면 "수정"버튼을 누르고

 

"C++를 사용한 데스크톱 개발"을 체크해서 설치하면 된다.

---

uv 프로젝트 준비

# uv 프로젝트를 파이썬 3.10으로 준비
uv init --python="C:\Users\{사용자명}\AppData\Local\Programs\Python\Python310\python.exe"

# 가상환경 준비
uv venv .venv

 

필요 패키지 설치

# 필요한 패키지들을 버전에 맞게 설치
uv pip install jupyterlab==4.0.11 ipywidgets==8.1.1 jupyterlab-widgets==3.0.9
uv pip install pygwalker==0.3.6 duckdb polars ipykernel pandas

 

가상환경을 커널에 등록

uv run python -m ipykernel install --user --name jupyter-venv --display-name "Python (.venv)"

 

Jupyter Lab 실행

uv run jupyter lab

 

Notebook을 만들 때 .venv 커널을 선택

---

이제 Jupyter Lab의 Notebook에서 PyGWalker로 데이터 분석을 할 수 있다.

고맙다 ChatGPT... 돈값 하는구나..