Quantum-Algorithms

A collection of fundamental quantum algorithms, written to be understood and compared with their classical counterparts, plus a starting setup for research-level work on quantum algorithms.

Reproducible quantum-algorithm workflows -- algorithms plus YAML experiment data feed classical or quantum/QPU backends, producing metrics, plots, logs and saved configs.

What is here

  • Two tracks. Python with Qiskit for circuits, simulators and hardware, and C++ with Armadillo for fast linear algebra.

  • Classical baselines. Each algorithm is meant to sit next to the best simple classical method for the same problem, so the comparison is concrete.

  • Reproducible experiments. Code is code, experiments are data: every run is described by a YAML file rather than numbers edited into source. See Configuration with YAML.

Getting started

Setup is a single command on macOS and Linux:

./install.sh
conda activate qalgos

The pages below cover the details, step by step.