Solution skill
ImportError: cannot import name 'ModelMetaclass' from 'pydantic.main'
Complete solution
Fixes ImportError: cannot import name 'ModelMetaclass' from 'pydantic.main' Use when v2 code importing ModelMetaclass from pydantic.main Not for: normal BaseModel subclassing (you never need the metaclass)
How to fix ImportError: cannot import name 'ModelMetaclass' from 'pydantic.main'
ModelMetaclass is not public API in v2. If you just need a model's metaclass, use type(YourModel) instead of importing it. If a library does this (motor-odm did), upgrade the library. The class does exist at pydantic._internal._model_construction, but that is private and can move between releases.
The exact error
ImportError: cannot import name 'ModelMetaclass' from 'pydantic.main'Fix it
Replace
from pydantic.main import ModelMetaclassusage:type(MyModel)gives you the metaclass. Expected: no import neededIf a library does this (motor-odm did), upgrade the library. Expected: fixed upstream
Last resort: import from
pydantic._internal._model_construction. Expected: works but pinned to internals
When this applies
v2 code importing ModelMetaclass from pydantic.main
When this does NOT apply
normal BaseModel subclassing (you never need the metaclass)
Versions
pydantic v2
Why it happens
v2 rebuilt the internals; ModelMetaclass left the public namespace.
Edge cases
Depending on _internal ties you to exact pydantic versions; avoid in libraries.
Evidence
Asked about: ImportError: cannot import name 'ModelMetaclass' from 'pydantic.main' (gh:pydantic/pydantic#6381). The verified fix: ModelMetaclass is not public API in v2. If you just need a model's metaclass, use type(YourModel) instead of importing it. If a library does this (motor-odm did), upgrade the library. The class does exist at pydantic._internal._model_construction, but that is private and can move between releases. Full thread: https://github.com/pydantic/pydantic/issues/6381
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_ahE58EiFPGitSuTu6xJqiw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">ImportError: cannot import name 'ModelMetaclass' from 'pydantic.main' <span>— Vectle</span></a>