LangChain: “당장 망가지진 않지만, 코드에서 외부 라이브러리 import 방법을 곧 바꾸라는 의미”

1. 경고 원인 요약

본 메시지는 "코드 자체 에러"가 아니라, LangChain 최신버전(특히 0.2.x 부터)에서의 경고(DeprecationWarning)입니다.
즉, “당장 망가지진 않지만, 코드에서 외부 라이브러리 import 방법을 곧 바꾸라는 의미”

주요 원인

• langchain 라이브러리의 내부 구조/모듈 경로 체계 변화

• Embeddings, Vector Store 등 기능 별로 이전에는 langchain.embeddings, langchain.vectorstores에서 직접 import

• 2024년 이후에는 기능별로 각각
  langchain_community.*
langchain_openai.*
  에서 import하도록 분리됨 (더 커뮤니티/브랜드별로)

주요 경고 메시지의 해석

from langchain.embeddings import OpenAIEmbeddings
          ↑↓↓↓
from langchain_community.embeddings import OpenAIEmbeddings

from langchain.vectorstores import Chroma
           ↑↓↓↓
from langchain_community.vectorstores import Chroma

from langchain.embeddings import OpenAIEmbeddings
        ↓↓↓
from langchain_openai import OpenAIEmbeddings

2. 왜 이렇게 바꼈나?

• LangChain의 발전에 따라

  • 커뮤니티가 만든(3rd party) 벡터스토어/임베딩 등은 langchain_community 패키지로 이동

  • OpenAI 등 특정 주요 서비스·공식지원은 langchain_openai 패키지로 이동

• 이렇게 함으로써,

  • 각 기능/패키지 유지보수 및 업데이트, 호환성 문제 예방

  • 필요 없는 기능을 억지로 설치할 필요가 없음

3. 대응 방법 (코드 수정)

아래처럼 import만 바꿔주면 경고 안 뜹니다!

변경 전

from langchain.embeddings import OpenAIEmbeddings
from langchain.vectorstores import Chroma

변경 후

from langchain_openai import OpenAIEmbeddings
from langchain_community.vectorstores import Chroma

만약 OpenAIEmbeddings가 langchain_openai 및 최신 패키지에서 여전히 경고가 난다면, 설치 버전 확인(아주 최신으로 pip install --upgrade langchain_openai 해주십시오).

4. 실제 실무용 코드 예시 (수정본)

from langchain_community.vectorstores import Chroma
from langchain_openai import OpenAIEmbeddings

5. 패키지 설치 명령 (필요하면 최신화)

pip install --upgrade langchain langchain-community langchain-openai

6. 기타 안내

• 경고이기 때문에 지금은 동작에 큰 문제 없음

• 하지만 곧(몇 달 내) 실제 오류(Exception)가 될 수 있으니 반드시 코드를 바꿔주세요!

7. 참고 링크

• LangChain 공식 버전 가이드

• Import 자동변환툴