Skip to content

JupyterLab 설치 및 실행 방법

Rajiv Chandra
Name
Rajiv Chandra

Updated on

JupyterLab은 노트북, 코드, 데이터 작업을 위한 현대적인 인터페이스입니다.
이 빠른 가이드를 통해 몇 분 안에 JupyterLab을 설치하고 시작할 수 있습니다.

1. Python과 pip 설치

JupyterLab은 Python 위에서 동작하므로, 먼저 Python(과 pip)을 설치해야 합니다.

Windows

다음 링크에서 최신 Python 설치 프로그램을 다운로드하세요:
👉 https://www.python.org/downloads/ (opens in a new tab)

설치 중에 “Add Python to PATH” 체크박스를 꼭 선택하세요.
pip는 자동으로 함께 설치됩니다.

macOS & Linux

대부분의 시스템에는 Python이 미리 설치되어 있습니다. 버전을 확인해 보세요:

python3 --version

Python이 없다면 다음과 같이 설치할 수 있습니다:

  • macOS (Homebrew):

    brew install python

  • Ubuntu / Debian:

    sudo apt install python3 python3-pip

2. JupyterLab 설치

Python과 pip 준비가 끝났다면, JupyterLab을 설치합니다:

pip install jupyterlab

이 명령은 최신 안정 버전(JupyterLab 4.x)을 설치합니다.

3. JupyterLab 실행

JupyterLab을 시작하려면:

jupyter lab

기본 웹 브라우저가 자동으로 열립니다.
이제 노트북을 만들고, Python 코드를 실행하며, 파일을 관리할 수 있습니다.

선택 사항: 가상 환경 만들기(권장)

가상 환경은 프로젝트별로 패키지를 분리해 관리할 수 있게 해 줍니다.

1. virtualenv 설치(필요한 경우)

pip install virtualenv

2. 가상 환경 생성

virtualenv myenv

3. 가상 환경 활성화

Windows

.\myenv\Scripts\activate

macOS & Linux

source myenv/bin/activate

4. 가상 환경 안에 JupyterLab 설치

pip install jupyterlab

5. JupyterLab 실행

jupyter lab

환경에서 나오려면:

deactivate

자주 묻는 질문 & 고급 주제

(초보자용 본문을 단순하게 유지하기 위해 뒤쪽에 배치했습니다.)

Q1: Conda로 JupyterLab을 설정하려면 어떻게 하나요?

Conda는 패키지와 환경을 함께 관리할 수 있어 데이터 사이언스에서 많이 사용됩니다.

1. Miniconda 또는 Anaconda 설치

2. 새 환경 만들기

conda create --name myenv

3. 환경 활성화

conda activate myenv

4. JupyterLab 설치

conda install -c conda-forge jupyterlab

5. JupyterLab 실행

jupyter lab

Q2: Jupyter Notebook에서 JupyterLab으로 업그레이드하려면?

Jupyter Notebook을 제거할 필요는 없습니다. 둘을 함께 설치해 둘 수 있습니다.

pip 사용

pip install jupyterlab

conda 사용

conda install -c conda-forge jupyterlab

설치 후에는 다음 명령만 실행하면 됩니다:

jupyter lab

기존 .ipynb 노트북은 그대로 정상적으로 열립니다.

Q3: (고급) 확장 기능이나 JupyterLab 4.x 기능은 어떤가요?

  • JupyterLab 4.x는 대부분의 확장 기능에서 Node.js가 필요 없도록 하는 새로운 확장 시스템을 사용합니다.

  • (테마, Git 연동, 변수 인스펙터 등) 많은 인기 확장이 JupyterLab 4를 지원합니다.

  • 확장을 설치하려면:

    pip install jupyterlab-language-pack-<lang>
pip install jupyterlab_git

  • 설치된 확장 목록을 보려면:

    jupyter labextension list

초보자라면, JupyterLab 사용에 익숙해질 때까지 확장 기능은 나중에 알아봐도 괜찮습니다.

Q4: (고급) Docker로 JupyterLab을 실행할 수 있나요?

네, 가능합니다. 예시는 다음과 같습니다:

docker run -p 8888:8888 jupyter/base-notebook

Q5: (고급) 여러 Python 커널을 관리하려면 어떻게 하나요?

서로 다른 환경에 대해 커널을 설치할 수 있습니다:

pip install ipykernel
python -m ipykernel install --user --name myenv