Installation

Prerequisites

• Python 3.12 or higher

• uv package manager

• Quantum hardware components (TimeTagger, rotators, etc.) — see Overview

Install uv

If you don’t have uv installed:

curl -LsSf https://astral.sh/uv/install.sh | sh

Clone and Install

git clone https://github.com/PublicQuantumNetwork/pqn-stack.git
cd pqn-stack

Install dependencies including the FastAPI web server:

uv sync --extra webapp

This installs all required packages into an isolated virtual environment managed by uv.

Verify Installation

Check that the pqn CLI is available:

uv run pqn --help

You should see a list of available commands.