Info:

Python bindings for libmongocrypt. See GitHub for the latest source.

Author:

Shane Harvey

About

Python wrapper library for libmongocrypt that supports client side encryption in drivers. PyMongoCrypt uses cffi and cryptography.

PyMongoCrypt supports Python 3.8+ and PyPy3.9+.

Support / Feedback

For issues with, questions about, or feedback for PyMongoCrypt, please look into our support channels. Please do not email any of the PyMongoCrypt developers directly with issues or questions - you’re more likely to get an answer on the mongodb-user list on Google Groups.

Bugs / Feature Requests

Think you’ve found a bug? Want to see a new feature in PyMongoCrypt? Please open a case in our issue management tool, JIRA:

Bug reports in JIRA for all driver projects (i.e. PYTHON, CSHARP) and the Core Server (i.e. SERVER) project are public.

How To Ask For Help

Please include all of the following information when opening an issue:

  • Detailed steps to reproduce the problem, including full traceback, if possible.

  • The exact python version used, with patch level:

    $ python -c "import sys; print(sys.version)"

  • The exact version of PyMongoCrypt used:

    $ python -c "import pymongocrypt; print(pymongocrypt.__version__)"

  • The exact version of libbmongocrypt used by PyMongoCrypt:

    $ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"

  • The exact version of PyMongo used (if applicable), with patch level:

    $ python -c "import pymongo; print(pymongo.version); print(pymongo.has_c())"

  • The operating system and version (e.g. Windows 7, OSX 10.8, …)

  • Web framework or asynchronous network library used, if any, with version (e.g. Django 1.7, mod_wsgi 4.3.0, gevent 1.0.1, Tornado 4.0.2, …)

Security Vulnerabilities

If you’ve identified a security vulnerability in a driver or any other MongoDB project, please report it according to the instructions here.

Installation

PyMongoCrypt can be installed with pip:

$ python -m pip install pymongocrypt
$ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"
1.9.0

PyMongoCrypt ships wheels for macOS, Windows, and manylinux2010 that include an embedded libmongocrypt build.

Installing from wheels on Linux requires pip 19 or later because it adds support for manylinux2010 wheels. Older versions of pip will attempt installation using the pymongocrypt-X.Y.tar.gz source distribution which requires the extra step of downloading and installing libmongocrypt as described below. Users can upgrade to pip 19 by running:

$ python -m pip install --upgrade 'pip>=19'

Installing from source

Installing from source (or the pymongocrypt-X.Y.tar.gz source distribution, or pip < 19 on Linux) requires an extra step of installing libmongocrypt. First, install PyMongoCrypt from source:

$ git clone git@github.com:mongodb/libmongocrypt.git
$ python -m pip install ./libmongocrypt/bindings/python

Next, install libmongocrypt:

Installing libmongocrypt

libmongocrypt is continuously built and published on evergreen.

Follow the instructions here to install the correct libmongocrypt build for your operating system.

Alternatively, the latest tarballs containing libmongocrypt binaries are published here. Download and extract the correct libmongocrypt.tar.gz for your operating system and set PYMONGOCRYPT_LIB to the path to your operating system’s libmongocrypt.so file.

For example:: macOS:

$ # Set PYMONGOCRYPT_LIB for macOS:
$ export PYMONGOCRYPT_LIB=$(pwd)/libmongocrypt/lib/libmongocrypt.dylib
$ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"
1.18.0

Windows:

$ # Set PYMONGOCRYPT_LIB for Windows:
$ chmod +x $(pwd)/libmongocrypt-all/windows-test/bin/mongocrypt.dll
$ export PYMONGOCRYPT_LIB=$(pwd)/libmongocrypt/bin/mongocrypt.dll
$ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"
1.18.0

Linux: set the libmongocrypt build for your platform, for example for Ubuntu 22.04 x86_64:

$ # Set PYMONGOCRYPT_LIB for Ubuntu 22.04 x86_64:
$ export PYMONGOCRYPT_LIB=$(pwd)/libmongocrypt/lib64/libmongocrypt.so
$ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"
1.18.0
$ # Check that native crypto is enabled for better performance:
$ python -c 'from pymongocrypt.binding import lib;print(lib.mongocrypt_is_crypto_available())'
True

Note if your Linux platform is not available, the generic linux-x86_64-glibc_2_7-nocrypto build should still be compatible however the “nocrypto” build will result in lower performance for encryption and decryption:

$ # Set PYMONGOCRYPT_LIB for linux-x86_64-glibc_2_7-nocrypto:
$ export PYMONGOCRYPT_LIB=$(pwd)/libmongocrypt/lib64/libmongocrypt.so
$ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"
1.18.0
$ python -c 'from pymongocrypt.binding import lib;print(lib.mongocrypt_is_crypto_available())'
False

Dependencies

PyMongoCrypt supports Python 3.8+ and PyPy3.9+.

PyMongoCrypt requires cffi and cryptography.

If not installed using one of the official wheels, PyMongoCrypt also requires libmongocrypt to be installed on your system. If libmongocrypt is not installed you will see an error like this:

>>> import pymongocrypt
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "pymongocrypt/__init__.py", line 15, in <module>
    from pymongocrypt.binding import libmongocrypt_version, lib
  File "pymongocrypt/binding.py", line 803, in <module>
    lib = ffi.dlopen(os.environ.get('PYMONGOCRYPT_LIB', 'mongocrypt'))
  File "/.../lib/python3.8/site-packages/cffi/api.py", line 146, in dlopen
    lib, function_cache = _make_ffi_library(self, name, flags)
  File "/.../lib/python3.8/site-packages/cffi/api.py", line 828, in _make_ffi_library
    backendlib = _load_backend_lib(backend, libname, flags)
  File "/.../lib/python3.8/site-packages/cffi/api.py", line 823, in _load_backend_lib
    raise OSError(msg)
OSError: ctypes.util.find_library() did not manage to locate a library called 'mongocrypt'

Use the PYMONGOCRYPT_LIB environment variable to load a locally installed libmongocrypt build without relying on platform specific library path environment variables, like LD_LIBRARY_PATH. For example:

$ export PYMONGOCRYPT_LIB='/path/to/libmongocrypt.so'
$ python -c "import pymongocrypt; print(pymongocrypt.libmongocrypt_version())"
1.9.0

Testing

The easiest way to run the tests is to run python setup.py test in the root of the distribution.

Project links

Data verified by PyPI on Sep 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for 10gen from gravatar.com 10gen

Credits

Author: Shane Harvey

GitHub Statistics

Data verified by PyPI on Sep 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache License)

Requires

Python >=3.9

Provides Extra

test

Tags

bson mongo mongocrypt mongodb pymongo pymongocrypt

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymongocrypt-1.19.0.tar.gz (69.7 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pymongocrypt-1.19.0-py3-none-win_amd64.whl (1.6 MB view details)

Uploaded Python 3Windows x86-64

pymongocrypt-1.19.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.8 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

pymongocrypt-1.19.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (4.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

pymongocrypt-1.19.0-py3-none-macosx_11_0_universal2.whl (4.7 MB view details)

Uploaded Python 3macOS 11.0+ universal2 (ARM64, x86-64)

File details

Details for the file pymongocrypt-1.19.0.tar.gz.

File metadata

  • Download URL: pymongocrypt-1.19.0.tar.gz
  • Upload date:
  • Size: 69.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pymongocrypt-1.19.0.tar.gz
Algorithm Hash digest
SHA256 9e1ce65161fb1166f73c4dc98e42047b5a2314eb14b7140aba06c82be1f9866d
MD5 f28b4f042cf71bf5d4cc2c4c0cbab236
BLAKE2b-256 020185c5ec690e272d5a5bf82a0390f40e8bbdaf6c0d96d7132d711f6e9e2076

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymongocrypt-1.19.0.tar.gz:

Publisher: release-python.yml on mongodb/libmongocrypt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pymongocrypt-1.19.0-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for pymongocrypt-1.19.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 aa80c0cf3df2923a40c41b48d219212afbd18ee7e6e77e7b1bc5e8dd6065534e
MD5 7126f8ec8032f294d0d71fb697036cfd
BLAKE2b-256 e8f109b0da5b02eab911aa87c477bc74e56bb7f662a97e23aa0c76cfd0744496

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymongocrypt-1.19.0-py3-none-win_amd64.whl:

Publisher: release-python.yml on mongodb/libmongocrypt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pymongocrypt-1.19.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for pymongocrypt-1.19.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3c0c551a8dee4ce790a2b676e37ade34536b2942fd0c90c591732fffcccc40c1
MD5 9a9af126afd11a1f8f6de05fd9833da6
BLAKE2b-256 5481bedcac784e8dfa8f0fb1c8aca649a7d1e57ac45e6b01b5f239f53bae4364

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymongocrypt-1.19.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-python.yml on mongodb/libmongocrypt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pymongocrypt-1.19.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for pymongocrypt-1.19.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 6caf4d61a55e59fceeb573d06b96ab181f71c2a4e8e7cfa7ba276c4f87b850fd
MD5 93451a6a62c5a626545d4758c4d299cd
BLAKE2b-256 baec04188792660bb68d7b6310de87e97072512c8ad5a41762d9aa0c49e85b9a

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymongocrypt-1.19.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl:

Publisher: release-python.yml on mongodb/libmongocrypt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pymongocrypt-1.19.0-py3-none-macosx_11_0_universal2.whl.

File metadata

File hashes

Hashes for pymongocrypt-1.19.0-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 7f831cb5e9c5bbe96199c748054aba3b9489c9bb2c5887a13c6922f1d2c64955
MD5 7153a075cc197cfa5ed47f4991d9e934
BLAKE2b-256 4a5a5fe43fccdedb4cebaf8130e1152eca765460098f27fac11ebaa0fc71053f

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymongocrypt-1.19.0-py3-none-macosx_11_0_universal2.whl:

Publisher: release-python.yml on mongodb/libmongocrypt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.19.0 This release

5 files

1.18.1

5 files

1.18.0

5 files

1.17.0

5 files

1.16.0

5 files

1.15.1

5 files

1.15.0

5 files

1.14.1

5 files

1.14.0

5 files

1.13.0

5 files

1.12.2

5 files

Pre-release

1.12.2rc4

5 files

1.11.0

5 files

1.10.1

5 files

1.10.0

5 files

Pre-release

1.10.0b1

5 files

1.9.2

6 files

1.9.1

6 files

1.8.0

6 files

1.7.0

6 files

1.6.1

6 files

1.6.0

6 files

1.5.2

6 files

1.5.1

6 files

1.5.0

6 files

1.4.1

6 files

1.4.0

6 files

1.3.1

6 files

Yanked

1.3.0

7 files

Yanked reason: pymongocrypt 1.3.0 was yanked because it contains a potential data corruption bug in RewrapManyDataKey (ClientEncryption.rewrap_many_data_key) when rotating encrypted data encryption keys backed by GCP or Azure key services. The bug is fixed in version 1.3.1. All users of 1.3.0 must upgrade.

1.2.0

5 files

1.1.2

5 files

1.1.1

5 files

1.1.0

4 files

1.0.1

4 files

1.0.0

4 files

Pre-release

0.1b3

4 files

Pre-release

0.1b2

4 files

Pre-release

0.1b1

4 files

Pre-release

0.1b0

3 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page