Get started
Installation
QXel is a high-performance, GPU-accelerated quantum circuit simulator that builds from source. It currently runs on Linux.
Prerequisites
Install these before building. The versions below are what QXel is tested with; lower versions usually work too. • Python ≥ 3.13.11 (Python ≥ 3.14 is incompatible with the AWS Braket SDK) • CMake ≥ 4.1.2 • Ninja ≥ 1.13.1 • pybind11 ≥ 2.13.6 • MKL and mkl-include ≥ 2025.0.0
Note QXel is Linux-only for now. For Windows, contact the team for access.
Build from source
Clone the repository and install it with pip. This compiles the C++/CUDA backend, so the first install takes a few minutes.
bash
git clone https://github.com/QubiStack/QXel
cd QXel
pip install .Troubleshooting a failed build
If the build fails (for example after upgrading a dependency), remove the build directory and reinstall:
bash
rm -rf build
pip install .