cirq-aqt

library1.6.1pypypi✓ verified 90d ago

A Cirq package to simulate and connect to Alpine Quantum Technologies (AQT) quantum computers. Version 1.6.1 is the current stable release, part of Cirq v1.6.1. Released as needed alongside Cirq core.

ai-ml

pip install cirq-aqt

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CIRQ-AQT

cirq-aqt

ai-mlpythonv1.6.1

Install

23.0s avg

Import

7694ms

Disk

538MB

Pass rate

6/ 10

Env Coverage6 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.5.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

1/2 runs

py 3.11

✓ —

✓ 22.25s

py 3.12

✓ —

✓ 22.95s

py 3.13

✓ —

✓ 23.85s

py 3.9

1/2 runs

538MB installed

● package 538MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

AQTSimulator

✓ from cirq_aqt import AQTSimulator

✗ from cirq.aqt import AQTSimulator

cirq-aqt is a separate package; import from cirq_aqt, not cirq.aqt.

AQTSampler

✓ from cirq_aqt import AQTSampler

✗ from cirq import AQTSampler

AQTSampler is in the cirq_aqt namespace.

get_aqt_device

✓ from cirq_aqt import get_aqt_device

AQTFuture

✓ from cirq_aqt import AQTFuture

Basic simulation using AQTSimulator.

import cirq from cirq_aqt import AQTSimulator # Create a simple circuit q0, q1 = cirq.LineQubit.range(2) circuit = cirq.Circuit([ cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1, key='result') ]) # Simulate sim = AQTSimulator() result = sim.simulate(circuit) print(result)

Debug

Known issues

deprecatedAQTSimulator is deprecated in favor of cirq.Simulator (from cirq-core) for local simulation. AQTSimulator may be removed in a future release.

fix

Use cirq.Simulator() for local simulation instead of AQTSimulator().

affects: >=1.0.0

gotchaAQTSampler requires valid API credentials (host, access_token) to connect to AQT hardware. Without proper auth, it raises an authentication error.

fix

Provide host and access_token parameters or set environment variables AQT_HOST and AQT_ACCESS_TOKEN.

affects: all

breakingCirq v1.6.0 dropped support for Python <3.11. Make sure your environment is using Python 3.11 or later.

fix

Upgrade Python to 3.11+ or use an older version of cirq-aqt (e.g., pip install cirq-aqt==1.5.0).

affects: >=1.6.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'cirq_aqt'

The cirq-aqt package is not installed or imported incorrectly.

fix

Install cirq-aqt: pip install cirq-aqt. Then import using 'from cirq_aqt import ...'.

AttributeError: module 'cirq' has no attribute 'AQTSimulator'

Importing from cirq instead of cirq_aqt.

fix

Use 'from cirq_aqt import AQTSimulator' instead of 'from cirq import AQTSimulator'.

Upgrade

Version history

1.6.1latest on PyPI · released Aug 14, 2025

Audit

Dependencies

cirq-corerequiredCore Cirq functionality

cirqoptionalFull Suite (optional meta-package)

Agent activity

20 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttp://github.com/quantumlib/cirq ↗

packagehttps://pypi.org/project/cirq-aqt/ ↗

homepagehttps://quantumai.google/cirq ↗