Quantum distributed computing library implemented over PyCOMPSs programming model for HPC.

Table of content:

• Description
• Requirements
• Installation
• Availability
• URLs
• Acknowledgements
• License

Description

Qdislib is a Python library designed for scalable quantum circuit execution using circuit cutting techniques. It enables the simulation of large quantum circuits by splitting them into smaller, manageable subcircuits that can be executed independently—either on classical simulators, GPUs, or quantum hardware.

Qdislib is built on top of the PyCOMPSs parallel runtime, allowing seamless distributed execution of quantum workloads across CPUs, GPUs, and QPUs.

With Qdislib, researchers and developers can:

• Perform gate and wire cutting to decompose complex quantum circuits.
• Leverage GPU acceleration using cuQuantum or Qibojit.
• Submit subcircuits to remote QPUs like IBM Quantum.
• Work with circuits defined in both Qibo and Qiskit.
• Automatically identify good cut points with find_cut.
• Extract and manipulate subcircuits independently.

Whether you're targeting HPC systems, hybrid quantum-classical setups, or constrained simulators, Qdislib is a flexible and modular tool to bridge the gap between current hardware limitations and large-scale quantum algorithm design.

Explore the sections below to get started with installation, quickstart examples, user guides, API references, and more.

Qdislib has been implemented on top of PyCOMPSs programming model, and it is being developed by the Workflows and Distributed Computing group of the Barcelona Supercomputing Center.

Requirements

• Python >= 3.10
• COMPSs >= 3.3

Python packages required are defined in requirements.txt:

Installation

Qdislib can be installed with the following command:

pip3 install qdislib

Availability

Currently, the following supercomputers have already PyCOMPSs and Qdislib installed and ready to use. If you need help configuring your own cluster or supercomputer, drop us an email and we will be pleased to help.

• Marenostrum 5 - Barcelona Supercomputing Center (BSC)

Citing Qdislib

If you use Qdislib in a scientific publication, we would appreciate citations to the following paper:

\M. Tejedor, B. Casas, J. Conejero, A. Cervera-Lierta and R. M. Badia, "Distributed Quantum Circuit Cutting for Hybrid Quantum-Classical High-Performance Computing" in https://www.arxiv.org/abs/2505.01184, 2025, pp. 1-12

Bibtex:

   @inproceedings{Qdislib,
               title       = {{Distributed Quantum Circuit Cutting for Hybrid Quantum-Classical High-Performance Computing}},
               author      = {Mar Tejedor and Berta Cervera and Javier Conejero and Alba Cervera-Lierta and Rosa M. Badia},
               booktitle   = {https://www.arxiv.org/abs/2505.01184},
               pages       = {1-12},
               year        = {2025},
    }

URLs

Quantum Distributed computing libraries BSC

Acknowledgements

The project acknowledges funding from the Spanish Ministry for Digital Transformation and of Civil Service of the Spanish Government through the QUANTUM ENIA project call - Quantum Spain, EU through the Recovery, Transformation and Resilience Plan – NextGenerationEU within the framework of the Digital Spain 2026. It acknowledges funding from Grant RYC2022-037769-I funded by MICIU/AEI/10.13039/501100011033 and by “ESF+”. It also acknowledges funding from projects CEX2021-001148-S, and PID2023-147979NB-C21 from the MCIN/AEI and MICIU/AEI /10.13039/501100011033 and by FEDER, UE, by the Departament de Recerca i Universitats de la Generalitat de Catalunya, research group MPiEDist (2021 SGR 00412).

License

Apache License Version 2.0, see LICENSE