The documentation of the project can be found here.

Install first the package dependencies with the following commands.

We recommend to start with a fresh virtual environment to avoid dependencies conflicts with previously installed packages.

python -m venv ./env
source activate ./env/bin/activate

The qibo-client package can be installed through pip:

pip install qibo-client

Once installed, the provider allows to run quantum circuit computations on remote labs using Qibo.

⚠️ Note: to run jobs on the remote cluster it is mandatory to own a validated account. Please, sign up to this link to obtain the needed token to run computations on the cluster.

The following snippet provides a basic usage example. Replace the your-token string with your user token received during the registration process. To check which devices are available with your account please visit the dashboard at https://cloud.qibo.science/.

import qibo
import qibo_client

# create the circuit you want to run
circuit = qibo.models.QFT(5)

# authenticate to server through the client instance
token = "your-token"
client = qibo_client.Client(token)

# run the circuit
device = "device_name"
job = client.run_circuit(circuit, nshots=1000, device=device)
result = job.result()
print(result)