Metadata-Version: 2.4
Name: qrmi
Version: 0.17.0
Classifier: Programming Language :: C
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Dist: python-dotenv
Requires-Dist: python-dateutil
Requires-Dist: qiskit-alice-bob-provider ; extra == 'alice-bob'
Requires-Dist: qrmi[ibm,pasqal,iqm] ; extra == 'all'
Requires-Dist: qiskit-ibm-runtime>=0.30.0 ; extra == 'ibm'
Requires-Dist: qiskit-qasm3-import ; extra == 'ibm'
Requires-Dist: iqm-client[qiskit] ; extra == 'iqm'
Requires-Dist: qiskit-pasqal-provider>=0.1.1 ; extra == 'pasqal'
Requires-Dist: pulser>=1.5.3 ; extra == 'pasqal'
Provides-Extra: alice-bob
Provides-Extra: all
Provides-Extra: ibm
Provides-Extra: iqm
Provides-Extra: pasqal
License-File: LICENSE.txt
Summary: Quantum Resource Management Interface(QRMI)
Keywords: quantum-computing,quantum-programming-language,qiskit,pulser,slurm,slurm-job-scheduler,slurm-workload-manager,python,rust
Author: Alice and Bob, IBM, Pasqal SAS and UKRI-STFC (Hartree Centre)
Author-email: qiskit@us.ibm.com
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: repository, https://github.com/qiskit-community/qrmi

# Quantum resource management interface (QRMI)

The Quantum resource management interface (QRMI) is a vendor-agnostic library for high-performance compute (HPC) systems to access, control, and monitor the behavior of quantum computational resources. It acts as a thin middleware layer that abstracts away the complexities associated with controlling quantum resources through a set of simple APIs. Written in Rust, this interface also exposes Python and C APIs for ease of integration into nearly any computational environment.

Find the source code to build and deploy QRMI in this [GitHub repository](https://github.com/qiskit-community/qrmi).

An optional task_runner command line tool to execute quantum payloads against quantum hardware is included in the Python package. Find the [full documentation](https://github.com/qiskit-community/qrmi/blob/main/python/qrmi/tools/task_runner/README.md) in the GitHub repository.

## Installation

### Python

We encourage installing QRMI via ``pip``:

```bash
pip install qrmi
```

To use a specific quantum resource, install QRMI with the corresponding optional dependencies:

```bash
pip install "qrmi[ibm]"       # Include dependencies for IBM
pip install "qrmi[iqm]"       # Include dependencies for IQM
pip install "qrmi[pasqal]"    # Include dependencies for Pasqal
pip install "qrmi[alice-bob]" # Include dependencies for Alice and Bob
pip install "qrmi[all]"       # Include dependencies for all quantum resources except `alice-bob`
```

Or combine multiple resources:

```bash
pip install "qrmi[ibm,pasqal]"
```

> [!NOTE]
> Note: `ibm` and `iqm` extras cannot be installed together, as they depend on incompatible versions of Qiskit.

> [!NOTE]
> Note: `alice-bob` cannot be installed alongside `ibm` or `iqm`, as it depends on Qiskit versions earlier than 2.0.

Pip will handle all dependencies automatically and you will always install the latest (and well-tested) version.

To install from source, follow the instructions in the [documentation](https://github.com/qiskit-community/qrmi/blob/main/INSTALL.md).

### Standalone C library

Prebuilt binaries for Linux(glibc 2.28 compatible) on x86_64, ppc64le, and aarch64 platforms are available for download from the [Releases](https://github.com/qiskit-community/qrmi/releases/latest) tab of this GitHub repository.

To install from source, follow the instructions in the [documentation](https://github.com/qiskit-community/qrmi/blob/main/INSTALL.md).


## Getting Started

This GitHub repository contains [a variety of example code](https://github.com/qiskit-community/qrmi/blob/main/examples). See the README in each directory for details.

One of example of usage of QRMI in compute infrastrcture project is Slurm plugin for quantum resources. QRMI is used in Slurm plugin to control quantum resources during lifetime of Slurm job. See implementation and documentation of [Quantum spank plugins for Slurm](https://github.com/qiskit-community/spank-plugins).

## How to Cite This Work

QRMI is the work of [many people](https://github.com/qiskit-community/qrmi/graphs/contributors) who contribute
to the project at different levels. If you use QRMI, please consider citing the associated overview paper  [Quantum resources in resource management systems](https://arxiv.org/abs/2506.10052). This helps support the continued development and visibility of the repository. The BibTeX citation handle can be found in the [BibTeX file](CITATION.bib) file.

Note we expect multiple versions of the overview paper to be released as the project evolves.


## Contribution Guidelines

For information on how to contribute to this project, please take a look at our [contribution guidelines](https://github.com/qiskit-community/qrmi/blob/main/CONTRIBUTING.md).

If you'd like to contribute to QRMI, please take a look at our
[contribution guidelines](https://github.com/qiskit-community/qrmi/blob/main/CONTRIBUTING.md). By participating, you are expected to uphold our [code of conduct](https://github.com/qiskit-community/qrmi/blob/main/CODE_OF_CONDUCT.md).

We use [GitHub issues](https://github.com/qiskit-community/qrmi/issues) for tracking requests and bugs. Please
[join the Qiskit Slack community](https://qisk.it/join-slack) for discussion, comments, and questions.


## References and Acknowledgements
1. Quantum spank plugins for Slurm https://github.com/qiskit-community/spank-plugins
2. Slurm documentation https://slurm.schedmd.com/
3. Qiskit https://www.ibm.com/quantum/qiskit
4. IBM Quantum https://www.ibm.com/quantum
5. Pasqal https://pasqal.com
6. STFC The Hartree Centre, https://www.hartree.stfc.ac.uk. This work was supported by the Hartree National Centre for Digital Innovation (HNCDI) programme.
7. Rensselaer Polytechnic Institute, Center for Computational Innovation, http://cci.rpi.edu/
8. Alice & Bob https://alice-bob.com/

