Module: cirq_google.engine.engine

Classes for running against Google's Quantum Cloud Service.

As an example, to run a circuit against the xmon simulator on the cloud, engine = cirq_google.Engine(project_id='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


class Engine: Runs programs via the Quantum Engine API.

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

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.

get_engine_sampler(...): Get an EngineSampler assuming some sensible defaults.

CIRCUIT_SERIALIZER Instance of cirq_google.serialization.CircuitSerializer