Skip to content

Development Guide

Project Overview

This project provides a Qiskit adapter for MQSS, allowing users to access MQSS backends through Qiskit. The main components of the project are:

  • adapter.py: Contains the MQSSQiskitAdapter class, which serves as the main entry point for accessing MQSS backends.
  • backend.py: Contains the MQSSQiskitBackend class, which interfaces with the MQSS backends.
  • job.py: Contains the MQSSQiskitJob class, which handles job cancellation, status checking, and result retrieval.
  • mqss_resource.py: Contains functions to retrieve the coupling map and target for the MQSS backend.

Prerequisites

Before you start developing, ensure you have the following installed:

  • Python 3.9 to 3.13
  • uv package manager for python

Setting Up the Development Environment

Clone the repository:

git clone https://github.com/Munich-Quantum-Software-Stack/MQSS-Qiskit-Adapter.git
cd MQSS-Qiskit-Adapter

Create a virtual environment and install the dependencies:

uv sync

Running Tests

To run the tests, use pytest:

uv run pytest

Building Documentation

To build the documentation, follow these steps:

Install MkDocs and the Material theme:

uv sync

Build the documentation:

uv run mkdocs build

Local deployment

Run the following and browse the documentation locally at: http://localhost:8000

uv run mkdocs serve