Metadata-Version: 2.4
Name: quantum-launcher
Version: 2.0.1
Summary: Quantum Launcher is modular tool, for solving many problems on many algorithms using many quantum computing backends
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: networkx
Requires-Dist: notebook>=7.3.2
Requires-Dist: numpy
Requires-Dist: overrides>=7.7.0
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: pyqubo>=1.5.0
Requires-Dist: scipy
Requires-Dist: qiskit
Requires-Dist: qiskit_algorithms
Requires-Dist: qiskit_aqt_provider
Requires-Dist: qiskit_ibm_runtime
Requires-Dist: qiskit_optimization
Requires-Dist: qiskit_aer
Requires-Dist: qcg-pilotjob
Requires-Dist: dill>=0.3.0
Provides-Extra: orca
Requires-Dist: numba==0.60.0; extra == "orca"
Requires-Dist: torch; extra == "orca"
Provides-Extra: dwave
Requires-Dist: dwave-ocean-sdk; extra == "dwave"
Requires-Dist: dwave-tabu>=0.5.0; extra == "dwave"
Provides-Extra: cirq
Requires-Dist: cirq>=1.4.1; extra == "cirq"
Requires-Dist: ply; extra == "cirq"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-httpx>=0.35.0; extra == "dev"
Dynamic: license-file

# Quantum Launcher

## About Project

Quantum Launcher is a high-level Python library that simplifies the process of running quantum algorithms. The library aims to make it easier to run, test, benchmark, and optimize quantum algorithms by providing tools that work across diverse configurations.

The library contains a rich collection of preset problems and algorithms, eliminating the need to repeatedly implement foundational components such as problem-specific QUBO formulations or Hamiltonians. This approach significantly reduces the overhead when benchmarking different quantum approaches.

Quantum Launcher introduces an intuitive architectural framework by dividing the quantum computation pipeline into three distinct components: Problem, Algorithm, and Backend. This separation creates a universal interface that allows researchers and developers to focus on specific aspects of quantum computation while maintaining compatibility across the entire ecosystem.

![Quantum Launcher](.figures/QL.png)

## Supported features

Additionally to ability of quickly changing tested problem, algorithm or backend Quantum Launcher comes with a bunch of useful features such as:

- Random problem instances generator.
- Automatic translation between problem formulations (e.g. QUBO -> Hamiltonian).
- QASM-based translation to match different frameworks (such as running qiskit's algorithm on cirq's computer).
- Asynchronous architecture to execute problems either standalone or in a grid.
- Access to more advanced workflows with qcg-pilotjob.
- Interface for simple profiling of algorithms.
- Creation of more complex workflows using WorkflowManager enabling splitting algorithms across multiple devices.

## Installation

To install the following library use the following script:

```sh
pip install quantum-launcher
```

### Optional Installs

Quantum Launcher aims to work for many different architectures. Therefore in order to remain compatible with all of them Quantum Launcher by default installs only necessary requirements allowing user to decide what frameworks does one want to use. To make installation easier, there is a bunch of downloads that can be done with optional dependencies, for example:

```sh
pip install 'quantum-launcher[orca]'
```

to install all requirements necessary to run qiskit algorithms.

- **qiskit**: support for IBM's qiskit algorithms and backends.
- **orca**: support for Orca Computing algorithms and backends **NOTE** library ptseries is not public therefore one needs to install it on it's own.
- **dwave**: support for D-Wave Systems algorithms and backends.
- **cirq**: support for Google's cirq backends.
- **pilotjob**: support for advanced job scheduling using Quantum Launcher and QCG PilotJob for more complex algorithm.

## Supported problems, algorithms and backends

Quantum Launcher was made to simplify using of multiple different problems, algorithms and backends, therefore adding new things is relatively easy.

Supported problems:

- MaxCut
- Exact Cover
- Job Shop Shedueling
- Air Traffic Management
- Traveling Salesman Problem
- Graph Coloring

For now supported backends are:

- Qiskit
- Orca Computing
- D-wave
- AQT
- Cirq

## Usage examples

Main idea of the project was to give a user quick and high level access to many different problems, algorithms and backends keeping interface simple.
For example to solve MaxCut problem with QAOA on qiskit simulator all you need to type is:

```py
# Necessary imports
from quantum_launcher import QuantumLauncher
from quantum_launcher.problems import MaxCut
from quantum_launcher.routines.qiskit_routines import QiskitBackend, QAOA

# Selecting problem, algorithm and backend
problem = MaxCut.from_preset('default')
algorithm = QAOA(p=3)
backend = QiskitBackend('local_simulator')

# Selecting launcher (Quantum Launcher by default, but other can be used for profiling/parallel processing)
launcher = QuantumLauncher(problem, algorithm, backend)

# Running the algorithm
result = launcher.run()
```

A key advantage of our library is that changing algorithms (such as switching to Quantum Annealing from Dwave) doesn't require manually specifying that MaxCut needs to provide QUBO representation - this translation happens automatically behind the scenes.

```py
# Necessary imports
from quantum_launcher import QuantumLauncher
from quantum_launcher.problems import MaxCut
from quantum_launcher.routines.dwave_routines import SimulatedAnnealingBackend, DwaveSolver

# Selecting problem, algorithm and backend
problem = MaxCut.from_preset('default')
algorithm = DwaveSolver()
backend = SimulatedAnnealingBackend('local_simulator')

# Selecting launcher (Quantum Launcher by default, but other can be used for profiling/parallel processing)
launcher = QuantumLauncher(problem, algorithm, backend)

# Running the algorithm
result = launcher.run()
```

## License

This project uses the [To Be determined License](LICENSE).
