Skip to content

LangChainで発生するModuleNotFoundError: langchain_communityの解決法

問題の説明

LangChainを使用して以下のインポートを実行しようとするとエラーが発生します:

python
from langchain_community.vectorstores import FAISS

発生するエラー内容:

ModuleNotFoundError: No module named 'langchain_community'

この問題は以下を試しても解決しない場合があります:

bash
pip install langchain-community

主な原因

このエラーが発生する主な理由は次のいずれかです:

  1. 必要な依存パッケージが不足している
  2. Pythonバージョンが不適合(最新バージョンで互換性問題が発生)
  3. 仮想環境の選択ミス(パッケージが別環境にインストールされている)

解決策一覧

方法1: 依存パッケージの同時インストール(推奨)

2024年2月時点で62票の支持を得た解決法
必要なコアパッケージをまとめてインストール:

bash
pip install langchain-community langchain-core

※ これでも解決しない場合、全パッケージを更新:

bash
pip install --upgrade langchain

Pythonバージョン要件:
Python 3.8.1以上が必須(3.12で問題が報告されています)


方法2: Pythonバージョンのダウングレード

Python 3.12ユーザー向けの有効な回避策

  1. Python 3.11をインストール(公式サイト
  2. 仮想環境を作成:
    bash
    python3.11 -m venv langchain-env
    source langchain-env/bin/activate  # Linux/Mac
    .\langchain-env\Scripts\activate   # Windows
  3. パッケージを再インストール:
    bash
    pip install --upgrade langchain

💡 方法3: IDEによる手動インストール(PyCharm例)

コンソールコマンドが機能しない場合の最終手段

  1. PyCharmでプロジェクトを開く
  2. File > Settings > Project > Python Interpreter
  3. +ボタンからパッケージを検索
  4. langchain-communityを選択しインストール

NOTE
同じ手順はVSCodeの「Python: Select Interpreter」や他の主要IDEでも利用可能


方法4: 仮想環境の再確認

パッケージが別環境にインストールされていないか確認:

bash
# アクティブな環境を確認
which python  # Linux/Mac
where python  # Windows

# 仮想環境を再アクティベート
source your_env/bin/activate  # 環境に合わせてパスを変更

根本原因と予防策

このエラーの背景にはLangChainのモジュール構造変更(2023年以降)があります。かつて単一パッケージだったものが、現在は:

  • langchain-core: 基本機能
  • langchain-community: サードパーティ統合
  • langchain: メタパッケージ

ベストプラクティス:

bash
# 推奨インストール方法(全コンポーネント取得)
pip install "langchain[all]"

# または最小構成でインストール
pip install langchain-core langchain-community

最新の互換性情報

Python 3.12サポートは開発中です。最新状況はLangChain公式GitHub Issuesで確認してください。2025年1月時点では、プロダクション環境ではPython 3.11の使用が推奨されています。