quantumlib/Qualtran: Qᴜᴀʟᴛʀᴀɴ is a Python library for expressing and analyzing Fault Tolerant Quantum algorithms.

Python package for fault-tolerant quantum algorithms research.

Installation – Usage – Documentation – Community – Citation – Contact

Qualtran is a set of abstractions for representing quantum programs and a library of quantum algorithms expressed in that language to support quantum algorithms research.

Installation

Qualtran is being actively developed. We recommend installing from the source code.

The following commands will clone a copy of the repository, then install the Qualtran package in your local Python environment as a local editable copy:

git clone https://github.com/quantumlib/Qualtran.git
cd Qualtran/
pip install -e .

You can also install the latest tagged release using pip:

pip install qualtran

You can also install the latest version of the main branch on GitHub:

pip install git+https://github.com/quantumlib/Qualtran

Usage

[!WARNING]

Qualtran is an experimental preview release. We provide no backwards compatibility guarantees.

Some algorithms or library functionality may be incomplete or contain inaccuracies. Open issues or

contact the authors with bug reports or feedback.

You should be able to import the qualtran package into your interactive Python environment as well as your programs:

import qualtran

If this is successful, you can move on to learning how to write bloqs or investigate the bloqs library.

Documentation

Documentation is available at https://qualtran.readthedocs.io/.

Community

Qualtran's community is growing rapidly, and if you'd like to join the [many open-source contributors] to the Qualtran project, we welcome your participation! We are dedicated to cultivating an open and inclusive community, and have a [code of conduct].

[many open-source contributors]: https://github.com/quantumlib/Qualtran/graphs/contributors [code of conduct]: https://github.com/quantumlib/Qualtran/blob/main/CODE_OF_CONDUCT.md

Announcements

You can stay on top of Qualtran news using the approach that best suits your needs:

• For releases and major announcements: join the low-volume mailing list [qualtran-announce].
• For releases only:

[qualtran-announce]: https://groups.google.com/g/qualtran-announce [repository notifications]: https://docs.github.com/en/subscriptions-and-notifications/get-started/configuring-notifications [Qualtran releases feed]: https://github.com/quantumlib/Qualtran/releases.atom [PyPI releases feed]: https://pypi.org/rss/project/qualtran/releases.xml

Questions and Discussions

• If you'd like to ask questions and participate in discussions, join the [qualtran-dev]

• Would you like to get more involved in Qualtran development? The biweekly _Qualtran Sync_

[qualtran-dev]: https://groups.google.com/g/qualtran-dev

Issues and Pull Requests

• Do you have a feature request or want to report a bug? [Open an issue on

• Do you have a code contribution? Read our [contribution guidelines], then

[Open an issue on GitHub]: https://github.com/quantumlib/Qualtran/issues/new/choose [contribution guidelines]: https://github.com/quantumlib/Qualtran/blob/main/CONTRIBUTING.md [pull request]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests

Citation

When publishing articles or otherwise writing about Qualtran, please cite the following:

@misc{harrigan2024qualtran,
    title={Expressing and Analyzing Quantum Algorithms with Qualtran},
    author={Matthew P. Harrigan and Tanuj Khattar
        and Charles Yuan and Anurudh Peduri and Noureldin Yosri
        and Fionn D. Malone and Ryan Babbush and Nicholas C. Rubin},
    year={2024},
    eprint={2409.04643},
    archivePrefix={arXiv},
    primaryClass={quant-ph},
    doi={10.48550/arXiv.2409.04643},
    url={https://arxiv.org/abs/2409.04643},
}

Contact

For any questions or concerns not addressed here, please email [email protected].

Disclaimer

This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.

Copyright 2025 Google LLC.