Metadata-Version: 2.4
Name: devqubit-qiskit
Version: 0.1.12
Summary: devqubit adapter for Qiskit
Author: devqubit
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: experiment-tracking,qiskit,quantum
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <3.14,>=3.11
Requires-Dist: devqubit-engine<0.2.0,>=0.1.12
Requires-Dist: qiskit-aer<0.18,>=0.17
Requires-Dist: qiskit-qasm3-import<0.7,>=0.6
Requires-Dist: qiskit<3,>=2.2
Description-Content-Type: text/markdown

# devqubit-qiskit

[![PyPI](https://img.shields.io/pypi/v/devqubit-qiskit)](https://pypi.org/project/devqubit-qiskit/)

Qiskit adapter for [devqubit](https://github.com/devqubit-labs/devqubit) — automatic circuit capture, backend snapshots, and result logging for Qiskit and Aer backends.

> [!IMPORTANT]
> **This is an internal adapter package.** Install via `pip install "devqubit[qiskit]"` and use the `devqubit` public API.

## Installation

```bash
pip install "devqubit[qiskit]"
```

## Usage

```python
from qiskit import QuantumCircuit
from qiskit_aer import AerSimulator
from devqubit import track

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

with track(project="bell-state") as run:
    backend = run.wrap(AerSimulator())
    job = backend.run(qc, shots=1000)
    counts = job.result().get_counts()
```

## What's Captured

| Artifact | Kind | Role |
|---|---|---|
| QPY binary | `qiskit.qpy.circuits` | `program` |
| OpenQASM 3 | `source.openqasm3` | `program` |
| Circuit diagram | `qiskit.circuits.diagram` | `program` |
| Measurement counts | `result.counts.json` | `result` |
| Full SDK result | `result.qiskit.result_json` | `result_raw` |
| Backend properties | `device.qiskit.raw_properties.json` | `device_raw` |
| Execution envelope | `devqubit.envelope.json` | `envelope` |

## Documentation

See the [Adapters guide](https://devqubit.readthedocs.io/en/latest/guides/adapters.html) for details on wrapping options, batch execution, and performance tuning.

## License

Apache 2.0
