Jupyter Notebook의 설치 및 실행 방법


1. Python 설치

Jupyter Notebook은 Python 환경에서 실행됩니다. Python이 설치되어 있지 않다면 먼저 설치해야 합니다.

(1) Python 설치

  • Python 공식 사이트에서 운영체제에 맞는 최신 버전을 다운로드하여 설치합니다.
  • 설치 중 “Add Python to PATH” 옵션을 선택하세요.

(2) Python 설치 확인

터미널이나 명령 프롬프트에서 아래 명령어를 입력하여 설치된 Python 버전을 확인합니다:

python --version

또는

python3 --version

2. pip 설치 확인

pip는 Python의 패키지 관리 도구입니다. 대부분 Python 설치 시 기본으로 포함되어 있지만 확인이 필요합니다.

pip --version

만약 pip가 설치되지 않았다면:

python -m ensurepip --upgrade

3. Jupyter Notebook 설치

pip를 사용하여 Jupyter Notebook을 설치합니다:

pip install notebook

4. Jupyter Notebook 실행

설치가 완료되면 아래 명령어로 Jupyter Notebook을 실행할 수 있습니다:

jupyter notebook

실행 후:

  • 기본 웹 브라우저가 열리며 Jupyter Notebook 대시보드가 표시됩니다.
  • 대시보드에서 새 파일을 생성하거나 기존의 .ipynb 파일을 열 수 있습니다.

5. 작업 디렉토리 설정

Jupyter Notebook은 현재 디렉토리를 기준으로 실행됩니다. 원하는 디렉토리에서 실행하려면 터미널에서 해당 디렉토리로 이동 후 실행하세요:

cd 원하는_경로
jupyter notebook

6. 주요 단축키 및 팁

  • Shift + Enter: 셀 실행 및 다음 셀로 이동
  • Ctrl + Enter: 셀 실행 후 해당 셀에 머무름
  • a: 현재 셀 위에 새 셀 삽입
  • b: 현재 셀 아래에 새 셀 삽입
  • dd: 셀 삭제
  • m: 셀을 Markdown 모드로 변경
  • y: 셀을 Code 모드로 변경

7. 필수 패키지 설치

Jupyter Notebook에서 데이터 분석 및 머신러닝 작업을 할 계획이라면 추가 패키지 설치를 추천합니다:

pip install numpy pandas matplotlib scikit-learn

8. 에러 발생 시 해결

(1) Jupyter 실행 시 ‘jupyter’ 명령어를 찾을 수 없음:

python -m notebook

위 명령어를 실행하거나, Python 환경변수 설정을 확인하세요.

(2) 특정 브라우저로 열리지 않음:

jupyter notebook --browser=chrome

9. Uninstall (제거)

Jupyter Notebook을 제거하려면 아래 명령어를 실행하세요:

pip uninstall notebook

WARNING: The script wsdump.exe is installed in ‘C:\Users\changewithai\AppData\Roaming\Python\Python313\Scripts’ which is not on PATH.

위 경고 메시지는 Python 패키지를 설치하는 동안 설치된 스크립트들이 PATH 환경 변수에 포함되지 않은 디렉토리에 배치되었음을 알려줍니다. 이로 인해 설치된 명령어들을 명령 프롬프트에서 직접 실행할 수 없을 수 있습니다. 이를 해결하려면 아래 단계를 따라 PATH를 설정하세요.

11. PATH 환경 변수 수정 방법 (Windows)

  1. 환경 변수 설정 열기
    • 작업 표시줄 검색창에 “환경 변수”를 입력하고, “시스템 환경 변수 편집”을 선택합니다.
  2. 환경 변수 편집
    • “환경 변수” 버튼을 클릭합니다.
    • 사용자 변수(User variables) 또는 시스템 변수(System variables)에서 Path 항목을 찾아 선택한 후 “편집” 버튼을 클릭합니다.
  3. 새로운 경로 추가
    • 경고 메시지에 표시된 디렉토리를 추가합니다:C:\Users\changewithai\AppData\Roaming\Python\Python313\Scripts
    • “새로 만들기” 버튼을 클릭한 후 위 경로를 입력합니다.
  4. 저장 및 닫기
    • 모든 창을 “확인”을 눌러 저장하고 닫습니다.
  5. 변경 사항 적용
    • 명령 프롬프트(cmd)를 재시작하여 변경된 PATH를 적용합니다.

12. 경고 메시지 무시

위 경고 메시지는 –no-warn-script-location 옵션으로 억제할 수 있습니다. 하지만 권장되지 않으며, PATH를 수정하는 것이 더 안전합니다.

13. 설정 후 확인

환경 변수가 올바르게 설정되었는지 확인하려면:

echo %PATH%

출력된 경로에 C:\Users\changewithai\AppData\Roaming\Python\Python313\Scripts가 포함되어 있으면 설정이 완료된 것입니다.

주피터 노트북 실행 화면