The circuit execution service enables the execution of quantum circuits on different quantum devices.
The service provides access to all quantum devices and quantum simulators available via IBMQ. Moreover, it allows users to execute quantum circuits on local simulators using noise models of real quantum devices. Thereby, users can choose between a complete noise model or a noise model that only includes measurement errors. Furthermore, this service also supports the german IBM quantum devices listed here.
The easiest way to get start is using a pre-built Docker image:
docker run -p 5075:5075 planqk/execution-service
Alternatively, the service can be built manually:
- Clone the repository using
git clone https://github.com/UST-QuAntiL/Quokka.git - Navigate to the corresponding folder within the cloned repository
cd Quokka/services/execution-service - Build the Docker container:
docker build -t execution-service . - Run the Docker container:
docker run -p 5075:5075 execution-service
Then the service can be accessed via: http://127.0.0.1:5075.
The execution service provides a Swagger UI, specifying the request schemas and showcasing exemplary requests for all API endpoints.
- Swagger UI: http://127.0.0.1:5075/api/swagger-ui.
git clone https://github.com/UST-QuAntiL/Quokka.git
cd Quokka/services/execution-service
# if virtualenv is not installed
sudo -H pip install virtualenv
# create new virtualenv called 'venv'
virtualenv venv
# activate virtualenv; in Windows systems activate might be in 'venv/Scripts'
source venv/bin/activate
#install application requirements.
pip install -r requirements.txt- Run the application with:
flask run --port=5075 - Test with:
python -m unittest discover - Coverage with:
coverage run --branch --include 'app/*' -m unittest discover; coverage report
black . OR black FILE|DIRECTORY
Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
Dies ist ein Forschungsprototyp. Die Haftung für entgangenen Gewinn, Produktionsausfall, Betriebsunterbrechung, entgangene Nutzungen, Verlust von Daten und Informationen, Finanzierungsaufwendungen sowie sonstige Vermögens- und Folgeschäden ist, außer in Fällen von grober Fahrlässigkeit, Vorsatz und Personenschäden, ausgeschlossen.
The initial code contribution has been supported by the project SEQUOIA funded by the Baden-Wuerttemberg Ministry of the Economy, Labour and Housing.