Classes for running against Google's Quantum Cloud Service.

As an example, to run a circuit against the xmon simulator on the cloud, engine ='my-project-id') program = engine.create_program(circuit) result0 =, repetitions=10) result1 =, repetitions=10)

In order to run on must have access to the Quantum Engine API. Access to this API is (as of June 22, 2018) restricted to invitation only.


engine_client module

engine_job module: A helper for jobs that have been created on the Quantum Engine.

engine_processor module

engine_program module

engine_sampler module


class Engine: Runs programs via the Quantum Engine API.

class EngineContext: Context for running against the Quantum Engine API. Most users should

class ProtoVersion: Protocol buffer version to use for requests to the quantum engine.


get_engine(...): Get an Engine instance assuming some sensible defaults.

get_engine_calibration(...): Returns calibration metrics for a given processor.

get_engine_device(...): Returns a Device object for a given processor.