LangChain을 사용하다 보면 아래와 같은 오류를 한 번쯤은 만나게 됩니다 👇
ModuleNotFoundError: No module named 'langchain_community'저도 PyCharm에서 from langchain.chat_models import ChatOpenAI를 실행하다가 이 오류를 처음 만났습니다.
이번 글에서는 오류의 원인과 정확한 해결 방법을 단계별로 정리했습니다.
🧩 1. 오류 원인
LangChain은 2024년 말 이후 버전에서 대규모 리팩토링이 있었습니다.
이전에는 모든 기능이 하나의 패키지(langchain)에 들어 있었지만,
이제는 다음과 같이 모듈이 세분화되었습니다 👇
| 이전 버전 | 변경된 모듈 |
|---|---|
langchain.chat_models |
langchain_openai |
langchain.llms |
langchain_community.llms |
langchain.vectorstores |
langchain_community.vectorstores |
즉, 최신 버전에서는 OpenAI 관련 클래스들이
별도 패키지(langchain_openai) 로 이동했습니다.
따라서 예전 코드처럼 다음과 같이 작성하면 👇
from langchain.chat_models import ChatOpenAI이제는 langchain.chat_models 내부에 ChatOpenAI가 존재하지 않아서No module named 'langchain_community' 오류가 발생하는 것입니다.
⚙️ 2. 해결 방법
✅ 방법 ① 최신 구조에 맞게 패키지 설치 및 import 변경
터미널(또는 PyCharm 터미널)에서 다음 명령어를 입력하세요 👇
pip install langchain_community langchain-openai설치 후, import 경로를 아래처럼 수정합니다:
from langchain_openai import ChatOpenAI
chat = ChatOpenAI(model="gpt-4o-mini")
response = chat.invoke("LangChain 최신 구조가 뭐야?")
print(response)이제 더 이상 langchain_community 관련 오류가 발생하지 않습니다 ✅
✅ 방법 ② 구버전 LangChain으로 되돌리기
기존 코드 호환성이 더 중요하거나,
프로젝트가 예전 버전 기반이라면 LangChain 버전을 고정하는 방법도 있습니다.
pip install langchain==0.0.350📌 참고
0.0.350 이전 버전에서는 모든 모듈이langchain내부에 포함되어 있으므로
기존 코드(from langchain.chat_models import ChatOpenAI)를 그대로 사용할 수 있습니다.
🧠 3. 정리
| 상황 | 해결 방법 |
|---|---|
| 최신 버전 유지하고 싶음 | pip install langchain_community langchain-openai + import 수정 |
| 기존 코드 호환성 유지 | pip install langchain==0.0.350 |
💬 4. 마무리
LangChain은 매우 빠르게 발전하고 있어서,
버전이 바뀔 때마다 import 경로나 모듈 구조가 종종 달라집니다.
하지만 이번 변경은 단순히 모듈 분리이기 때문에,
다음 두 가지만 기억하면 됩니다 👇
- ✅
langchain_community: 커뮤니티 유지보수 모델 (LLMs, Vectorstore 등) - ✅
langchain_openai: OpenAI 계열 모델(ChatOpenAI, OpenAIEmbeddings 등)
이 두 개만 설치하고 import 경로를 변경하면 대부분의 문제가 해결됩니다!
📦 5. 패키지 설치 모음
한 번에 설치하고 싶다면 아래 명령어로 끝낼 수 있습니다 👇
pip install langchain langchain_community langchain-openai openai📘 6. requirements.txt 예시
langchain==0.2.11
langchain_community==0.2.10
langchain-openai==0.2.8
openai==1.12.0이렇게 버전을 고정해두면 팀 단위 개발 시 버전 충돌을 방지할 수 있습니다.
🎯 최종 요약
ModuleNotFoundError: No module named 'langchain_community'🔍 원인: LangChain 구조 개편으로 모듈이 분리됨
🔧 해결:
pip install langchain_community langchain-openai🔄 import 변경:
from langchain_openai import ChatOpenAI
💡 추가 팁
- LangChain 문서가 빠르게 업데이트되므로,
버전별 공식 문서를 확인하는 습관을 들이는 것이 좋습니다.
👉 LangChain 공식 문서
댓글