Skip to main content
Version: latest

Getting Started with Qumat

Installation​

Install Qumat from PyPI:

pip install qumat

Install with QDP (Quantum Data Plane) support:

pip install qumat[qdp]

From Source (Development)​

For development or the latest changes, use uv:

git clone https://github.com/apache/mahout.git
cd mahout
pip install uv
uv sync                     # Core Qumat
uv sync --extra qdp         # With QDP (requires NVIDIA GPU + CUDA)
Why uv?

The project uses uv to handle dependency overrides required for Python 3.10+ compatibility with some backend dependencies.

Basic Usage​

from qumat import QumatCircuit

circuit = QumatCircuit(2)
circuit.h(0)
circuit.cx(0, 1)
result = circuit.run()
print(result)

Dependencies​

Prior to installation, ensure Python 3.10-3.12 is installed. Dependencies such as Qiskit, Cirq, and Amazon Braket SDK are managed automatically.

Apache Release​

Official source releases are available at apache.org/dist/mahout.

To verify the integrity of a downloaded release:

gpg --import KEYS
gpg --verify mahout-qumat-0.5.zip.asc mahout-qumat-0.5.zip

Examples​

Refer to repository examples:

  • examples/Simple_Example.ipynb
  • examples/Optimization_Example.ipynb

Next Steps​