mickahell/qatcomputer repository overview

⁠Qat Computer

The project is aimed to create a Qiskit base docker image to use as base for any quantum application using Qiskit. The image also contains the tool QatComputer who allows you to run a python project directly inside the container as a run as you go.

Full documentation available at QatComputer docs⁠.

⁠Prerequisites

• Linux

  apt-get install docker-ce docker-ce-cli containerd.io

  Copy

• Mac / Windows

  https://www.docker.com/products/docker-desktop

⁠Details

• The image is base on Ubuntu The Jammy Jellyfish⁠
• Python version install : 3.10⁠

⁠Getting started

The image is available in DockerHub and can be clone with :

docker clone ...

Most of the usefull commands are available in the Docker Compose file⁠ and in the makefile⁠.

⁠Build

if you want to build your own image :

docker build . --build-arg FULL=False --file docker/Dockerfile --tag qatcomputer:latest

⁠Compute

Parameters for the tool can be given as docker extra parameters. A configuration file is also available with every parameters :

# log
## 0 : Informational
## 1 : Warning
## 2 : Error --> Always
## 3 : Critical --> Always
loglevel: 0   # Optionnal
debian_packages:   # Optionnal
  - "jq"
python_version: "python3.10"   # Optionnal
compute_path: "simple_python_repository"
filename_to_execute: "main.py"
requirements_file: "requirements.txt"   # Optionnal

In order to start the image and make the internal tool available :

docker run -d --rm --privileged --cgroupns=host \
	--name qatcomputer \
	-v /sys/fs/cgroup:/sys/fs/cgroup:rw \
	-v $(PWD)/qat_computer/resources/conf:/etc/qat-computer/conf \
	-v $(PWD)/qat_computer/resources/compute:/etc/qat-computer/compute \
	qatcomputer:latest

And run the tool :

docker exec --tty qatcomputer \
	qat-computer compute -conf=conf_docker.yaml