Research completed 2026-07-23 using official IBM Quantum documentation, Qiskit repositories and releases, PyPI metadata, Context7's Qiskit indexes, and Parallel web search/extraction.
PyPI versions observed:
| Distribution | Version | PyPI |
|---|---|---|
| Qiskit SDK | 2.5.0 | qiskit |
| Qiskit IBM Runtime | 0.48.0 | qiskit-ibm-runtime |
| Qiskit Aer | 0.17.2 | qiskit-aer |
| Qiskit Algorithms | 0.4.0 | qiskit-algorithms |
| Qiskit Nature | 0.8.0 | qiskit-nature |
| Qiskit Nature PySCF | 0.4.0 | qiskit-nature-pyscf |
| Qiskit Machine Learning | 0.9.0 | qiskit-machine-learning |
| Qiskit Optimization | 0.7.0 | qiskit-optimization |
The Qiskit GitHub repository published 2.5.1 on 2026-07-23, shortly before this update. At verification time, PyPI metadata still reported 2.5.0, so executable examples use the available qiskit==2.5.0 pin. Recheck both sources before updating.
- IBM Quantum documentation
- Qiskit quickstart
- Install Qiskit
- Qiskit SDK API reference
- Qiskit SDK release notes
- Qiskit 2.5 release notes
- Qiskit GitHub repository
- Qiskit GitHub releases
Use quantum.cloud.ibm.com/docs for current guides. Old qiskit.org/learn, qiskit.org/ecosystem/..., and legacy documentation URLs can be stale or redirect.
- Construct circuits
- Circuit library API
- Quantum information API
- QPY serialization API
- OpenQASM 2 API
- OpenQASM 3 API
- Introduction to primitives
- Primitive input and output
- Exact simulation with SDK primitives
- Primitives API
- Qiskit 2.0 migration guide
- Qiskit 1.0 feature changes
- Qiskit package-structure migration
- Migrate BackendV1 to BackendV2
- Migrate to V2 Runtime primitives
- Migrate Qiskit Pulse to fractional gates
- Migrate from IBM Quantum Platform Classic
Qiskit 2.0 removed qiskit.pulse, legacy instruction conditions, V1 reference primitive implementations, and several BackendV1-era interfaces. Runtime V1 primitive support was removed earlier. Read both SDK and Runtime migration guides because they version independently.
- Qiskit IBM Runtime repository
- Runtime client release notes
- QiskitRuntimeService API
- Runtime SamplerV2 API
- Runtime EstimatorV2 API
- Set up IBM Quantum Platform
- Runtime execution modes
- Run jobs in a batch
- Run jobs in a session
- Runtime local testing mode
- Sampler options
- Estimator options
- Error mitigation and suppression
Runtime 0.48 uses ibm_quantum_platform, V2 primitives, mode=..., implementation-specific options, and explicit ISA circuits.
The Aer documentation landing page can lag the newest patch label. Use PyPI and GitHub releases for the install pin, then use versioned API behavior from the installed package.
- Qiskit Algorithms 0.4
- Qiskit Nature 0.8
- Qiskit Nature getting started
- Qiskit Machine Learning 0.9
- Qiskit Machine Learning migration guide
- Qiskit Optimization 0.7
- Qiskit Optimization migration guides
Application packages release independently. Check their requirements before changing the core Qiskit pin.
- Qiskit addon: circuit cutting
- Qiskit addon: sample-based quantum diagonalization
- Qiskit addon: operator backpropagation
- Qiskit addon: multi-product formulas
- Qiskit addon: AQC-Tensor
- IBM guide to Qiskit addons
Addon versions observed on PyPI:
| Distribution | Version |
|---|---|
qiskit-addon-cutting |
0.10.0 |
qiskit-addon-sqd |
0.12.1 |
qiskit-addon-obp |
0.3.0 |
qiskit-addon-mpf |
0.3.0 |
qiskit-addon-aqc-tensor |
0.3.1 |
The refresh used focused Parallel searches for:
- current Qiskit, Runtime, Aer, and application-package versions,
- Qiskit 2.x removals, deprecations, and migration guides,
- current Runtime authentication, execution modes, and option models,
- current circuit, primitive, transpilation, simulation, and serialization guides,
- current ecosystem and addon package APIs.
Canonical pages were then extracted directly. Specific API patterns were cross-checked with Context7 and executed in isolated uv environments pinned to the versions above.
- Query PyPI JSON metadata for every pinned distribution.
- Compare PyPI with GitHub releases and official release notes.
- Read Qiskit major/minor migration and deprecation sections.
- Read Runtime release notes independently.
- Recheck valid channel names, account setup, plan restrictions, and option compatibility.
- Run all bundled scripts in an isolated environment.
- Execute the core, Algorithms, Optimization, Machine Learning, and visualization snippets.
- Update the verification date and version tables.
- Increment
metadata.versioninSKILL.md. - Run
uv run skills-ref validate skills/qiskitand the local security scan.