Skip to content

Install

Binary Tarball

We provide a traditional binary tarball based on nix-user-chroot. Note that the tarball requires Linux kernel user namespaces to work.

A list of all released versions of isQ compiler binaries can be seen at https://www.arclightquantum.com/isq-releases/isqc-standalone/.

VERSION=0.1.1
# Create empty directory for isQ installation.
mkdir isqc && cd isqc
# Check if user namespace is supported for your Linux kernel.
unshare --user --pid echo YES
# Download and unpack tarball.
wget https://www.arclightquantum.com/isq-releases/isqc-standalone/${VERSION}/isqc-${VERSION}.tar.gz
wget https://www.arclightquantum.com/isq-releases/isqc-standalone/${VERSION}/isqc-${VERSION}.tar.gz.sha256
sha256sum -c isqc-${VERSION}.tar.gz.sha256
tar -xvf isqc-${VERSION}.tar.gz
# Now isQ is here.
./isqc --version

isQ is built with Nix Flakes, making it super easy to obtain when you have Nix installed:

# Add isQ binary cache to Cachix to prevent building from source.
nix-shell -p cachix --run "cachix use arclight-quantum"
# Enter the environment with isQ installed.
nix shell github:arclight-quantum/isQ-Compiler
# Now isQ is placed in $PATH.
isqc --version

Or you may create a project folder pinned to a compiler version.

nix flake new --template github:arclight-quantum/isQ-Compiler hello-quantum
cd hello-quantum && nix develop

Docker Container

We provide two Docker images with isQ compiler builtin: one for normal users providing a full Ubuntu environment, and the other for professional Docker users with only binary files necessary for isQ.

# Ubuntu-based Docker image.
docker run -it arclightquantum/isqc:ubuntu-0.0.1 bash
isqc --version # Run in container.
# Binary only Docker image.
docker run --rm -v $(pwd):/workdir arclightquantum/isqc:0.0.1 isqc --version