Diagnose: ImportError: cannot import name 'ChatOpenAI' from 'langchain'

TL;DR

For "ImportError: cannot import name 'ChatOpenAI' from 'langchain'": run python -c "import langchain; print(langchain.\\version\\)". `python from langchain\_openai import ChatOpenAI # needs pip install langchain-openai or provider-agnostic: python from langchain.chat\_models import init\_chat\_model model = init\_chat\_model("openai:gpt-5.5")

ImportError: cannot import name 'ChatOpenAI' from 'langchain'

Steps

1. Run python -c "import langchain; print(langchain.__version__)". If it is 1.x, the old import path is gone by design, not by accident.
2. LangChain v1 shrank the langchain namespace to agents, messages, tools, chat models (init functions), and embeddings. Model classes moved to provider packages. Training data and old tutorials still teach the pre-v1 paths.

from langchain_openai import ChatOpenAI # needs pip install langchain-openai

3. or provider-agnostic:

from langchain.chat_models import init_chat_model
model = init_chat_model("openai:gpt-5.5")

4. Import the class and construct it. Then grep the codebase for other stale imports from langchain (langchain.chat_models classes, langchain.llms, langchain.embeddings classes); they fail the same way and it is cheaper to fix them all now.

When to use

You are seeing this: ` ImportError: cannot import name 'ChatOpenAI' from 'langchain' ` Use this skill when you run into "Diagnose: ImportError: cannot import name 'ChatOpenAI' from 'langchain'".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

LangChain v1 shrank the langchain namespace to agents, messages, tools, chat models (init functions), and embeddings.

Diagnostic procedure grounded in the official v1 migration guide, verified 2026-09-26. Migration guide: docsgchain.com/oss/python/migrate/langchain-v1