ModuleNotFoundError: No module named 'sentence_transformers'" 해결 방법

파이썬을 공부하거나 프로젝트를 진행하다 보면 가장 자주 마주치는 에러 중 하나인 **ModuleNotFoundError**군요!

이 에러는 파이썬이 실행될 때 sentence_transformers라는 라이브러리가 설치되어 있지 않거나, 설치된 위치를 찾지 못해서 발생합니다. 특히 자연어 처리(NLP) 모델을 다룰 때 이 라이브러리가 필수적인데, 아래 단계별 해결 방법을 따라 하시면 금방 해결될 거예요.

1. 라이브러리 설치하기
가장 일반적인 원인은 라이브러리가 설치되지 않은 경우입니다. 터미널(또는 CMD, PowerShell)에서 아래 명령어를 입력해 보세요.

Bash
pip install sentence-transformers
만약 설치 속도가 너무 느리다면, 한국 거울 서버(PyPI mirror)를 이용해 빠르게 설치할 수 있습니다.

Bash
pip install sentence-transformers -i https://pypi.tuna.tsinghua.edu.cn/simple
2. 주피터 노트북(Jupyter/Colab)을 사용하는 경우
노트북 환경에서는 터미널이 아닌 셀(Cell)에 직접 아래 내용을 입력하고 실행해야 합니다.

Python
!pip install sentence-transformers
Tip: 설치가 끝난 후에는 **런타임(커널)을 다시 시작(Restart Kernel)**해야 설치된 패키지를 정상적으로 인식할 수 있습니다.

3. 가상환경(Venv/Conda) 문제 확인
라이브러리를 분명히 설치했는데도 같은 에러가 난다면, 설치한 곳과 실행하는 곳이 다르기 때문일 확률이 높습니다.

VS Code 사용 시: 오른쪽 하단(또는 오른쪽 상단)에 표시된 Python 인터프리터 버전이 라이브러리를 설치한 환경과 일치하는지 확인하세요.

Conda 사용 시: conda activate [환경이름]으로 해당 환경에 들어간 뒤 설치했는지 확인해 보세요.

설치 확인용 코드
설치가 완료되었다면, 아래 코드를 실행해서 에러 없이 라이브러리가 불러와지는지 확인해 보세요.

Python
from sentence_transformers import SentenceTransformer

# 모델을 불러올 때 에러가 없다면 성공입니다!
model = SentenceTransformer('all-MiniLM-L6-v2')
print("성공적으로 라이브러리를 불러왔습니다.")
혹시 위 단계를 다 시도했는데도 여전히 같은 에러가 발생하나요? 그렇다면 현재 사용 중인 **개발 환경(VS Code, PyCharm, Colab 등)**을 알려주시면 더 구체적인 맞춤 해결책을 드릴 수 있습니다!