Skip to main content

Microsoft Quantum Development Kit for Chemistry (QDK/Chemistry)

QDK/Chemistry is an open-source C++ and Python package within the Microsoft Quantum Development Kit (QDK). It provides an end-to-end toolkit for quantum chemistry: from molecular setup and classical electronic structure through quantum algorithm execution and simulation. Designed as both a development platform and a composable framework, QDK/Chemistry enables researchers to assemble modular quantum–classical pipelines, explore strongly correlated systems, and advance toward practical quantum chemistry applications on near-term and fault-tolerant quantum computers.

Overview

QDK/Chemistry bridges classical computational chemistry with quantum computing by providing every stage of the quantum applications pipeline in a single, modular toolkit:

  • Quantum algorithms: a growing collection of chemistry-aware quantum algorithms, with composable building blocks for constructing higher-level quantum workflows
  • Classical electronic structure: production-quality classical methods that generate the high-quality inputs quantum algorithms require
  • Composable architecture: a plugin system that lets users assemble custom pipelines from interchangeable components, mixing native high-performance C++ backends with established community packages
  • Multiple quantum backends: execute circuits on a variety of simulators through a unified interface that decouples algorithm development from backend selection

Documentation

  • Website: The full documentation is hosted online
  • C++ API: Headers in cpp/include/ contain comprehensive Doxygen documentation
  • Python API: All methods include detailed docstrings with Parameters, Returns, Raises, and Examples sections
  • Examples: See the examples/ directory and documentation for usage examples
  • Reference data and companion materials: Curated simulation datasets, molecular benchmarks, and related assets are available at microsoft/qdk-chemistry-data

Installing

python3 -m venv venv && source venv/bin/activate
python3 -m pip install 'qdk-chemistry[all]'

The [all] extra pulls in all optional dependencies so that examples and tests work without chasing missing packages. For other installation methods (Dev Container, building from source) and platform-specific notes, see INSTALL.md.

Telemetry

By default, this library collects anonymous usage and performance data to help improve the user experience and product quality. The telemetry implementation can be found in telemetry.py and all telemetry events are defined in telemetry_events.py.

To disable telemetry via bash, set the environment variable QSHARP_PYTHON_TELEMETRY to one of the following values: none, disabled, false, or 0. For example:

export QSHARP_PYTHON_TELEMETRY='false'

Alternatively, telemetry can be disabled within a python script by including the following at the top of the .py file:

import os
os.environ["QSHARP_PYTHON_TELEMETRY"] = "disabled"

If you have any questions about the library's use of Telemetry, please use the Discussion forum.

Citing QDK/Chemistry

If you use QDK/Chemistry in your work, please cite the following paper:

N. A. Baker, B. Bilodeau, C. Chen, Y. Chen, M. Eckhoff, A. Efimovskaya, P. Gasparotto, P. van Gerwen, R. Gong, K. Hoang, Z. Hooshmand, A. J. Jenkins, C. S. N. Johnston, R. R. Li, J. Liang, H. Liu, A. Mills, M. Mörchen, G. Nishibuchi, C. Sun, B. Ticehurst, M. Troyer, J. P. Unsleber, S. Wernli, D. B. Williams-Young, and B. Zhang, "QDK/Chemistry: A Modular Toolkit for Quantum Chemistry Applications," arXiv:2601.15253 (2026).

Contributing

There are many ways in which you can participate in this project, for example:

If you are interested in fixing issues and contributing directly to the code base, please see the document How to Contribute.

Support

For help and questions about using this project, please see SUPPORT.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

License

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT license.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft’s Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-parties’ policies.

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

qdk_chemistry-2.1.0-cp314-cp314-win_amd64.whl (63.3 MB view details)

Uploaded CPython 3.14Windows x86-64

qdk_chemistry-2.1.0-cp314-cp314-manylinux_2_39_x86_64.whl (65.4 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.39+ x86-64

qdk_chemistry-2.1.0-cp314-cp314-manylinux_2_39_aarch64.whl (62.9 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.39+ ARM64

qdk_chemistry-2.1.0-cp314-cp314-macosx_26_0_arm64.whl (58.4 MB view details)

Uploaded CPython 3.14macOS 26.0+ ARM64

qdk_chemistry-2.1.0-cp313-cp313-win_amd64.whl (63.3 MB view details)

Uploaded CPython 3.13Windows x86-64

qdk_chemistry-2.1.0-cp313-cp313-manylinux_2_39_x86_64.whl (65.4 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.39+ x86-64

qdk_chemistry-2.1.0-cp313-cp313-manylinux_2_39_aarch64.whl (62.9 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.39+ ARM64

qdk_chemistry-2.1.0-cp313-cp313-macosx_26_0_arm64.whl (58.3 MB view details)

Uploaded CPython 3.13macOS 26.0+ ARM64

qdk_chemistry-2.1.0-cp312-cp312-win_amd64.whl (63.3 MB view details)

Uploaded CPython 3.12Windows x86-64

qdk_chemistry-2.1.0-cp312-cp312-manylinux_2_39_x86_64.whl (65.4 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.39+ x86-64

qdk_chemistry-2.1.0-cp312-cp312-manylinux_2_39_aarch64.whl (62.9 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.39+ ARM64

qdk_chemistry-2.1.0-cp312-cp312-macosx_26_0_arm64.whl (58.3 MB view details)

Uploaded CPython 3.12macOS 26.0+ ARM64

qdk_chemistry-2.1.0-cp311-cp311-win_amd64.whl (63.3 MB view details)

Uploaded CPython 3.11Windows x86-64

qdk_chemistry-2.1.0-cp311-cp311-manylinux_2_39_x86_64.whl (65.4 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.39+ x86-64

qdk_chemistry-2.1.0-cp311-cp311-manylinux_2_39_aarch64.whl (62.9 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.39+ ARM64

qdk_chemistry-2.1.0-cp311-cp311-macosx_26_0_arm64.whl (58.3 MB view details)

Uploaded CPython 3.11macOS 26.0+ ARM64

qdk_chemistry-2.1.0-cp310-cp310-win_amd64.whl (63.2 MB view details)

Uploaded CPython 3.10Windows x86-64

qdk_chemistry-2.1.0-cp310-cp310-manylinux_2_39_x86_64.whl (65.4 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.39+ x86-64

qdk_chemistry-2.1.0-cp310-cp310-manylinux_2_39_aarch64.whl (62.9 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.39+ ARM64

qdk_chemistry-2.1.0-cp310-cp310-macosx_26_0_arm64.whl (58.3 MB view details)

Uploaded CPython 3.10macOS 26.0+ ARM64

File details

Details for the file qdk_chemistry-2.1.0-cp314-cp314-win_amd64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 a0b787ac10129125a910ab78934aa798257027df01a4fa7fc21c20efa05bac29
MD5 46e5f00207f17fb655bdf6f6c497d7dd
BLAKE2b-256 7bf85c7de29707fbf7e5f67a68816a291a112b3c6bb65b0c9c21bedb2fa5929b

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp314-cp314-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp314-cp314-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 ed7eba84b6413c53f77e33f51db18992307dc560e8d4a489f3898068b20f2498
MD5 1c9e10b4ebdc91363c2f900ce043ddad
BLAKE2b-256 1b55da4b71a0822ef0012b1c4e5d4ffc7509815e58459baa1392b994eac7709e

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp314-cp314-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp314-cp314-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 f34ec7a2ee8f40cd8da01b016a85a95db73d3210c6e63c81420fcf161f156862
MD5 5aabc5d41de5fc8829d89df9c2470f31
BLAKE2b-256 156a2e4ea09c35c3b878a997e764049954598e36c54ea67c682d7cde160af6a0

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp314-cp314-macosx_26_0_arm64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp314-cp314-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 da4cfa593fd3fe9afb8a756d4f74b6e64e3ef218ef7da6688b8e18d785c7cf7e
MD5 c185c635f3fc7dd69a6a4d6bb8444a28
BLAKE2b-256 8650db003b01bb210f7fae80707f596fa1bb210273e99cfa1f3322a9f9439d82

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 43ab9d2b7a62f5366a640ac28294132cb448a362ebb7e81158e96178e0901821
MD5 2aaa3acc4b0efde3004361f05af26bee
BLAKE2b-256 153c33cafc4441ba348a718dd3bfe82ff8827be97a0d4ad577c546253ef07758

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp313-cp313-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp313-cp313-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 e75a11ed4c164fc273f4719078ac8465bde0b58e238ecf987e802453b2ab2a34
MD5 12a34372a67abb3ea5009d22e83de2d6
BLAKE2b-256 e7dedd07017630251e14f37f320947db2c96bd888b248e400e7b6ae4d589616f

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp313-cp313-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp313-cp313-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 96da4e5b823b08da61a89585a1cefd6369ad3fa5f4eab2983d399f07f6ebe159
MD5 15534eca0c32051bb893d892d2489eaf
BLAKE2b-256 c752ef51d6016197141a8e25d78c9fdda8398e37d90433d220cf72f75d349ba6

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp313-cp313-macosx_26_0_arm64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp313-cp313-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 8297c7fb385cd1bdab1ecfb246c8c3fa22057e4e87737904d9dfee189b35ecf9
MD5 246ba2bc8a51f8c985bdbf9d7c2ea231
BLAKE2b-256 1096e03b56d9be4313ad683861485f0840f231a17cd43db315cfefb488d919ce

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b718c0bf2dfd1eb0f874f9332cb8f57595a457b47c3744755a7249a09db6994a
MD5 1e0c1219e98537bc90f1f5c7af2bd29d
BLAKE2b-256 11ec0d8d90a1afc7462a08d8258265967d83a3eb07c8d7297909aa28a7c1e594

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp312-cp312-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp312-cp312-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 6d4a8dc3846c07cbc7dbe2c61a7f254017f21808182b7eb20e26a10ac00642c7
MD5 9c134b5b86406c429cee1a9d892ca7f0
BLAKE2b-256 d2e557855e1935cd07b270b19cbe816f02b5da0168affc58a9c16aaf6af381f2

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp312-cp312-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp312-cp312-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 22ea185484447b3c2e28b36aac595db52b342404fdf9b20855f05379958a5ec1
MD5 f17ed7d388a17c947b164449280590a5
BLAKE2b-256 58779da0479d6895b5a94a0edaff941d79fe89c2b8d04fbccb5bb7b623434b1a

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp312-cp312-macosx_26_0_arm64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp312-cp312-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 288054b48da75392049d351f0458f6fd65b27590a5d1c5a809b93eeee49eaba9
MD5 b02b831f2f90f3eb38bc3f8066372ca5
BLAKE2b-256 22e6d8473dcd931f527eb186868417fce90fc1cf207b45af2c8e569c01c463a2

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 0ad5872467fc7071f72a54a760af9510e1d125b527b9c094324fbcfa0ccc4b2b
MD5 289ee595d39f215e54dbcd4419d05ff8
BLAKE2b-256 b5b824217956a7ab53a04f632a20e8ad6ab24b2c56e6129608785bc5fcbf242c

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp311-cp311-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp311-cp311-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 f25692365b26aa9c5712ade231874aa558c4186150b85f2007735d43eda80d96
MD5 3fb3827c781566a9a2f6f3b5c2d4dde2
BLAKE2b-256 014f1560d497da9acfc09ef2cf016166ab4ca096d5f982f073d4bc18e1085308

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp311-cp311-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp311-cp311-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 49b01cb5f1e5a84b49b43e66134634dc274e8f3c1e1a646c8c1b2e8013d37196
MD5 7d17ab009d9bee1037e7ea2e9d84e324
BLAKE2b-256 a3a49cc84df33f37ef7b5b881255cb1394704f12b232c35b2d8d4341f9f161bd

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp311-cp311-macosx_26_0_arm64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp311-cp311-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 15062c8e54c7fea00f002a3d92d14720019d24bf1487bdde6fd3a7291a9e225a
MD5 67950b113423df889b3ae080e05bf764
BLAKE2b-256 c24fcd61a401332b95be737ba1c3bb61112362ff9a8e0c99389f69ee2f1f2f9c

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 67ee5eb9be6e21e0d1abfd7fa09809a18be46bd3e42fa310833da257738df72c
MD5 87110b204c0503f96e663399615379c6
BLAKE2b-256 6c32cb7bb22ad55cf4aeaeae43dcb8afcaf985762b6437d286451d10a1fa3b13

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp310-cp310-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp310-cp310-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 8cd84030808f80dbfe142e5084e393445c36dc9c45aea23500c9e752d302ac6e
MD5 51da31800639750ef132e22a17e60e3d
BLAKE2b-256 4abc84878b26f01fffd3af631aac4794d50e62665e246d3e6dc19bebfd2d240f

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp310-cp310-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp310-cp310-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 45fcd2b521ef4f0538a91c79ec400727b44919fa5cb31df8b377f9e1f2895c7e
MD5 bf837d18e789cd9bbbbffca118dc9fd0
BLAKE2b-256 013553990249f0d70dc0b6ef57307f379426a1ee12009bc65da44448c4f014ec

See more details on using hashes here.

File details

Details for the file qdk_chemistry-2.1.0-cp310-cp310-macosx_26_0_arm64.whl.

File metadata

File hashes

Hashes for qdk_chemistry-2.1.0-cp310-cp310-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 92a8c04eb512114517e7db4af5e997a0e102922d864358841bda3149f3266be1
MD5 14e736f962d13dd01e85c8411303ec60
BLAKE2b-256 43a2c1e02d514d9912b245b7ad7f725f07423ffa62fdeb5061f41e8c1f48b181

See more details on using hashes here.

Release history Release notifications | RSS feed

2.2.0

24 files

This release

2.1.0 This release

20 files

2.0.0

20 files

1.1.0

15 files

1.0.2

15 files

1.0.1

15 files

1.0.0

9 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