Metadata-Version: 2.4
Name: clifft-qiskit
Version: 0.1.0
Summary: Qiskit BackendV2 provider for the Clifft near-Clifford simulator
Project-URL: Homepage, https://github.com/unitaryfoundation/clifft-qiskit
Project-URL: Issues, https://github.com/unitaryfoundation/clifft-qiskit/issues
Project-URL: Repository, https://github.com/unitaryfoundation/clifft-qiskit
Author: Ashmit JaiSarita Gupta
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: clifford,clifft,qiskit,quantum,simulator
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.12
Requires-Dist: clifft>=0.4
Requires-Dist: numpy>=1.26
Requires-Dist: qiskit>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: qiskit-aer>=0.17; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: twine>=6.0; extra == 'dev'
Description-Content-Type: text/markdown

# clifft-qiskit

A [Qiskit](https://www.ibm.com/quantum/qiskit) `BackendV2` provider for the
[Clifft](https://github.com/unitaryfoundation/clifft) near-Clifford simulator.
Run Qiskit circuits on Clifft without hand-writing Stim.

## Install
```bash
pip install clifft-qiskit
```

## Quickstart
```python
from qiskit import QuantumCircuit
from clifft_qiskit import ClifftProvider

qc = QuantumCircuit(2, 2)
qc.h(0); qc.cx(0, 1); qc.measure([0, 1], [0, 1])

backend = ClifftProvider().get_backend("clifft")
counts = backend.run(qc, shots=1000).result().get_counts()
print(counts)
```

## Supported basis
Clifford+T plus single-qubit rotations: `h s sdg x y z cx cy cz t tdg rx ry rz`
(+ `measure`). Higher-level gates (`ccx`, `u`, controlled rotations, …) are
decomposed into this basis by `qiskit.transpile` inside `run()`.

## Limitations
- Terminal measurement + counts only (no mid-circuit measurement / feedforward).
- `reset` and other non-unitary ops raise `QiskitError`.
- Single synchronous backend, all-to-all connectivity.

## License
Apache-2.0.
