ModuleNotFoundError: No module named openai 및 bs4

Python을 사용하다 보면 아래와 같은 에러 메시지를 한 번쯤은 마주하게 됩니다:

ModuleNotFoundError: No module named 'openai'

혹은

ModuleNotFoundError: No module named 'bs4'

이 에러는 해당 Python 모듈이 설치되어 있지 않다는 뜻입니다. 초보 개발자부터 전문가까지 겪을 수 있는 흔한 오류지만, 간단한 조치로 바로 해결할 수 있습니다. 이번 포스트에서는 이 두 오류의 원인과 해결 방법을 쉽고 명확하게 소개합니다.

에러 원인

• openai 모듈: OpenAI API (예: ChatGPT, GPT-4 등)를 사용하려면 반드시 설치되어 있어야 합니다.
• bs4 모듈: BeautifulSoup4 라이브러리로, 웹 크롤링 또는 HTML 파싱에 필수적입니다.

해결 방법

1. openai 모듈 설치

터미널(또는 명령 프롬프트)에 다음 명령어를 입력하세요:

pip install openai

Python 3을 명시적으로 사용할 경우:

pip3 install openai

설치 후 정상 작동 확인:

import openai
print(openai.__version__)

2. bs4 모듈 설치

다음 명령어로 BeautifulSoup4를 설치하세요:

pip install beautifulsoup4

Python 3의 경우:

pip3 install beautifulsoup4

설치 후 정상 작동 확인:

from bs4 import BeautifulSoup
print(BeautifulSoup)

자주 발생하는 실수 체크리스트

• 가상환경(venv, conda 등)을 사용하는 경우, 활성화한 후 모듈을 설치해야 합니다.

# macOS / Linux
source venv/bin/activate

# Windows
.\venv\Scripts\activate

그 다음:

pip install openai
pip install beautifulsoup4

• 여러 개의 Python이 설치되어 있는 경우, 잘못된 버전에 설치할 수 있습니다. which python 또는 where python으로 경로를 확인하세요.

마무리

Python에서 ModuleNotFoundError는 어렵지 않게 해결할 수 있는 오류입니다. 정확한 환경에서 필요한 패키지를 설치하면 문제는 간단히 해결됩니다.
이제 더 이상 openai 또는 bs4 관련 오류로 개발이 중단되는 일은 없을 것입니다!