Mac에서 Jupyter Lab 환경 구축하기: 설치부터 고급 설정까지

들어가며

Jupyter Lab은 데이터 과학, 머신러닝, 프로그래밍 등 다양한 분야에서 필수적인 개발 환경으로 자리 잡았습니다. 이 글에서는 Mac 환경에서 Homebrew를 이용해 Jupyter Lab을 설치하고, 효율적인 작업을 위한 다양한 설정 방법을 알아보겠습니다.

기본 설치 과정

1. Homebrew를 이용한 설치

Homebrew는 Mac에서 패키지를 관리하는 가장 편리한 도구입니다. 터미널을 열고 다음 명령어를 실행합니다:

brew install jupyterlab

2. 실행 확인

설치가 완료되면 다음 명령어로 Jupyter Lab을 실행합니다:

jupyter lab

기본적으로 http://localhost:8888/lab에서 실행되지만, 포트가 이미 사용 중이라면 다른 포트(예: 8889)가 자동으로 할당됩니다.

확장 기능 설치

Jupyter Lab의 진가는 다양한 확장 프로그램을 통해 발휘됩니다. 필수적인 확장 프로그램은 다음과 같습니다:

pip install jupyterlab-git        # Git 통합
pip install jupyterlab-lsp        # 코드 자동완성 및 린팅
pip install jupyterlab-drawio     # 다이어그램 그리기

버전 호환성 문제 해결

확장 프로그램 설치 중 종종 버전 충돌이 발생할 수 있습니다. 특히 jupyterlab-lsp는 jupyterlab 4.1.0 이상의 버전을 요구하는 경우가 많습니다:

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
jupyterlab-lsp 5.1.0 requires jupyterlab<5.0.0a0,>=4.1.0, but you have jupyterlab 3.6.8 which is incompatible.

이 문제를 해결하기 위해 Jupyter Lab을 업그레이드합니다:

pip install --upgrade jupyterlab>=4.1.0
pip install jupyterlab-lsp  # 업그레이드 후 다시 설치

고급 설정 옵션

1. 테마 변경

Jupyter Lab에서는 밝은 테마와 어두운 테마를 선택할 수 있습니다:

• 상단 메뉴에서 Settings > Theme를 선택
• JupyterLab Light, JupyterLab Dark 등 원하는 테마 선택

2. 가상환경 커널 추가

여러 프로젝트에서 독립적인 환경을 사용하고 싶다면 가상환경을 커널로 추가할 수 있습니다:

python -m ipykernel install --user --name 가상환경이름 --display-name "표시할이름"

3. 시작 디렉토리 변경

특정 디렉토리에서 Jupyter Lab을 시작하고 싶다면:

jupyter lab --notebook-dir="원하는/경로"

4. 비밀번호 보안 설정

공용 환경이나 원격 서버에서 사용할 때는 비밀번호 설정이 필요합니다:

jupyter lab password

시스템 시작 시 자동 실행 설정

Mac에서 시스템 부팅 시 Jupyter Lab을 자동으로 실행하려면 LaunchAgent를 설정합니다:

1. LaunchAgents 디렉토리 생성

mkdir -p ~/Library/LaunchAgents

2. plist 파일 생성

nano ~/Library/LaunchAgents/com.jupyter.lab.plist

다음 내용을 추가합니다 (경로는 자신의 환경에 맞게 수정):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.jupyter.lab</string>
    <key>ProgramArguments</key>
    <array>
        <string>/YOUR_PATH_TO_CONDA/miniconda3/bin/jupyter</string>
        <string>lab</string>
        <string>--no-browser</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

3. 서비스 등록 및 시작

launchctl load ~/Library/LaunchAgents/com.jupyter.lab.plist

패키지 관리 팁

최신 버전의 pip를 유지하면 많은 의존성 문제를 예방할 수 있습니다:

pip install --upgrade pip

마무리

이제 Mac에서 Jupyter Lab 환경이 완벽하게 구축되었습니다. 코드 자동완성, Git 통합, 다이어그램 작성 등 다양한 기능을 활용하여 효율적인 데이터 분석과 프로그래밍을 진행할 수 있습니다. 필요에 따라 추가 확장 프로그램을 설치하거나 설정을 커스터마이징하여 자신만의 최적화된 환경을 만들어보세요.

데이터 과학 여정의 첫걸음을 성공적으로 내딛었습니다. 이제 남은 것은 여러분의 창의적인 프로젝트뿐입니다!