Skip to content

Installation

Requirements

  • Python 3.11 (exactly; <3.12 is required by some IQM dependencies)
  • pip >= 26.0
  • Git
  • Valid LEXIS platform credentials
  • Access to LEXIS quantum resources

A virtual environment (venv or uv) is strongly recommended.

Install py4lexis

py4lexis handles LEXIS authentication and must be installed first:

pip3.11 install \
  --index-url https://opencode.it4i.eu/api/v4/projects/107/packages/pypi/simple \
  py4lexis

Install QaaS

From GitHub (stable):

pip3.11 install git+https://github.com/It4innovations/quantum-as-a-service.git@main

For development (editable install):

git clone https://github.com/It4innovations/quantum-as-a-service.git
cd quantum-as-a-service
pip3.11 install -e .

Optional extras

The iqm_backend extra is needed to run the backend service directly on IQM hardware nodes:

pip3.11 install "qaas[iqm_backend]"

Dependency overview

Package Version Purpose
qiskit 1.4.5 Quantum circuit framework
iqm-client[qiskit] 33.0.* IQM quantum interface
iqm-pulla 12.0.* Pulse-level optimisation
qiskit_aer >=0.15,<1.0 Circuit simulation
Py4HEAppE >=2.5.0 HEAppE job management
numpy >2.0.0 Numerical processing
cryptography >=43.0.0 Cryptographic operations
PyJWT[crypto] 2.10.* JSON Web Token handling