Requirements¶
Warning
As of May 14th, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async API. No new features will be added to Motor, and only bug fixes will be provided until it reaches end of life on May 14th, 2026. After that, only critical bug fixes will be made until final support ends on May 14th, 2027. We strongly recommend migrating to the PyMongo Async API while Motor is still supported. For help transitioning, see the Migrate to PyMongo Async guide.
The current version of Motor requires:
CPython 3.10 and later.
PyMongo 4.9 and later.
Motor can integrate with either Tornado or asyncio.
The default authentication mechanism for MongoDB is SCRAM-SHA-1.
Building the docs requires sphinx.
Compatibility Matrix¶
Motor and PyMongo¶
Motor Version |
PyMongo Version |
|---|---|
2.5 |
3.12+ |
3.0 |
4.1+ |
3.1 |
4.2+ |
3.2 |
4.4+ |
3.3 |
4.5+ |
3.4 |
4.5+ |
3.5 |
4.5+ |
3.6 |
4.9 |
3.7 |
4.9+ |
Motor and MongoDB¶
MongoDB Version |
|||||||||
|---|---|---|---|---|---|---|---|---|---|
3.6 |
4.0 |
4.2 |
4.4 |
5.0 |
6.0 |
7.0 |
8.0 |
||
Motor Version |
2.5 |
Y |
Y |
Y |
Y |
Y |
N |
N |
N |
3.0 |
Y |
Y |
Y |
Y |
Y |
N |
N |
N |
|
3.1 |
Y |
Y |
Y |
Y |
Y |
Y |
N |
N |
|
3.2 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
|
3.3 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
|
3.4 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
|
3.5 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
|
3.6 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
|
3.7 |
N |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
|
There is no relationship between PyMongo and MongoDB version numbers, although the numbers happen to be close or equal in recent releases of PyMongo and MongoDB. Use the PyMongo compatibility matrix to determine what MongoDB version is supported by PyMongo. Use the compatibility matrix above to determine what MongoDB version Motor supports.
Motor and Tornado¶
Where “N” appears in this matrix, the versions of Motor and Tornado are known to be incompatible, or have not been tested together.
Tornado Version |
|||||
|---|---|---|---|---|---|
Motor Version | 2.5 |
N |
N |
Y |
Y |
|
3.0 |
N |
N |
N |
Y |
|
3.1 |
N |
N |
N |
Y |
|
3.2 |
N |
N |
N |
Y |
|
3.3 |
N |
N |
N |
Y |
|
3.4 |
N |
N |
N |
Y |
|
Motor and Python¶
Motor 2.5 deprecated support for Python 3.5.
Motor 3.0 dropped support for Pythons older than 3.7.
Motor 3.1.1 added support for Python 3.11.
Motor 3.3 added support for Python 3.12.
Motor 3.5 dropped support for Python 3.7 and added support for Python 3.13.
Motor 3.7 dropped support for Python 3.8.
Motor 3.8 dropped support for Python 3.9 and added support for Python 3.14.
Python Version |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
3.6 |
3.7 |
3.8 |
3.9 |
3.10 |
3.11 |
3.12 |
3.13 |
3.14 |
||
Motor Version |
1.0 |
Y |
N |
N |
N |
N |
N |
N |
N |
N |
1.1 |
Y |
N |
N |
N |
N |
N |
N |
N |
N |
|
1.2 |
Y |
Y |
N |
N |
N |
N |
N |
N |
N |
|
1.3 |
Y |
Y |
N |
N |
N |
N |
N |
N |
N |
|
2.0 |
Y |
Y |
N |
N |
N |
N |
N |
N |
N |
|
2.1 |
Y |
Y |
Y |
N |
N |
N |
N |
N |
N |
|
2.2 |
Y |
Y |
Y |
N |
N |
N |
N |
N |
N |
|
2.3 |
Y |
Y |
Y |
N |
N |
N |
N |
N |
N |
|
2.4 |
Y |
Y |
Y |
Y |
N |
N |
N |
N |
N |
|
2.5 |
Y |
Y |
Y |
Y |
Y |
N |
N |
N |
N |
|
3.0 |
N |
Y |
Y |
Y |
Y |
N |
N |
N |
N |
|
3.1 |
N |
Y |
Y |
Y |
Y |
Y |
N |
N |
N |
|
3.2 |
N |
Y |
Y |
Y |
Y |
Y |
N |
N |
N |
|
3.3 |
N |
Y |
Y |
Y |
Y |
Y |
Y |
N |
N |
|
3.4 |
N |
Y |
Y |
Y |
Y |
Y |
Y |
N |
N |
|
3.5 |
N |
N |
Y |
Y |
Y |
Y |
Y |
N |
N |
|
3.6 |
N |
N |
Y |
Y |
Y |
Y |
Y |
Y |
N |
|
3.7 |
N |
N |
N |
Y |
Y |
Y |
Y |
Y |
N |
|
3.8 |
N |
N |
N |
N |
Y |
Y |
Y |
Y |
Y |
|
Not Supported¶
Motor does not support Jython or IronPython.