qiskit-aer
Aer - High performance simulators for Qiskit
What it is and what it does
Qiskit-aer is a simulator backend that executes quantum circuits defined in Qiskit on classical hardware. It models quantum state evolution using statevector, density matrix, or unitary representations, and can inject realistic noise based on actual quantum hardware characteristics. The package depends on qiskit, numpy, scipy, psutil, and python-dateutil, and provides both low-level simulator access and high-level primitives (EstimatorV2 and SamplerV2) for variational and sampling workloads.
Developers use Aer to prototype and test quantum algorithms before running them on real quantum processors, to study the effects of noise on circuit performance, and to run parameter sweeps over large circuit families. It is the reference simulator for the Qiskit ecosystem and is widely used in quantum algorithm research and education.
Use it for:
- Prototype and debug quantum algorithms locally before submitting to real quantum hardware.
- Study how noise models from specific quantum processors affect circuit outcomes.
- Run parameter sweeps and variational optimization loops efficiently on classical hardware.
- Simulate Bell states, GHZ states, and other entanglement patterns for educational purposes.
- Benchmark quantum algorithms across different noise configurations and circuit depths.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Aer is a high-performance quantum circuit simulator for Qiskit that executes quantum algorithms with realistic noise models and supports both CPU and GPU backends.
Yes. Aer is the standard simulator for Qiskit, actively maintained, has no known vulnerabilities, and carries a permissive Apache 2.0 license. Install friction is moderate due to C++ compilation, but prebuilt wheels cover modern Python versions and common platforms. Essential if you are working with Qiskit; optional only if you have no need to simulate quantum circuits locally.
Install
qiskit-aer on PyPI
pip
pip install qiskit-aeruv
uv add qiskit-aerpoetry
poetry add qiskit-aerInstalling qiskit-aer
Before you install
Medium install friction due to compiled C++ components; prebuilt wheels available for Python 3.7–3.12 across macOS, Windows, and Linux (including ARM and ppc64le). GPU variants require CUDA 11.2+ or 12 and are x86_64 Linux only. Repository is actively maintained with recent commits.
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes, but no copyleft obligations apply.
Quickstart
pip install qiskit-aer
from qiskit_aer import AerSimulator
from qiskit import QuantumCircuit, transpile
sim = AerSimulator()
circuit = QuantumCircuit(2)
circuit.h(0)
circuit.cx(0, 1)
circuit.measure_all()
transpiled = transpile(circuit, sim)
job = sim.run(transpiled)
result = job.result()
print(result.get_counts())
GPU support requires CUDA 11.2+ (or CUDA 12 for qiskit-aer-gpu) and is only available on x86_64 Linux; CPU-only installation works on macOS, Windows, and Linux across multiple architectures.
Verify before relying
- Performance benchmarks comparing CPU vs. GPU simulation on typical circuit sizes and depths.
- Specific noise model fidelity or accuracy claims relative to real hardware.
- Whether EstimatorV2 and SamplerV2 primitives are stable or still in development.
- Default shot count or sampling behavior when not explicitly specified.
Package facts
| License | Apache 2.0 (permissive) |
| Python support | supports the current Python release (>=3.7) |
| Install friction | medium — platform-specific wheel |
| Runtime dependencies | 5 — qiskit, numpy, scipy, psutil, python-dateutil |
| Maintenance | actively maintained — 331 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 853,066/month — #4,898 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: qiskit_aer-0.17.2-cp310-cp310-macosx_10_9_x86_64.whl; qiskit_aer-0.17.2-cp310-cp310-macosx_11_0_arm64.whl; qiskit_aer-0.17.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; qiskit_aer-0.17.2-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl; qiskit_aer-0.17.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; qiskit_aer-0.17.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; qiskit_aer-0.17.2-cp310-cp310-win32.whl; qiskit_aer-0.17.2-cp310-cp310-win_amd64.whl; qiskit_aer-0.17.2-cp311-cp311-macosx_10_9_x86_64.whl; qiskit_aer-0.17.2-cp311-cp311-macosx_11_0_arm64.whl; qiskit_aer-0.17.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; qiskit_aer-0.17.2-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl; qiskit_aer-0.17.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; qiskit_aer-0.17.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; qiskit_aer-0.17.2-cp311-cp311-win32.whl; qiskit_aer-0.17.2-cp311-cp311-win_amd64.whl; qiskit_aer-0.17.2-cp312-cp312-macosx_10_13_x86_64.whl; qiskit_aer-0.17.2-cp312-cp312-macosx_11_0_arm64.whl; qiskit_aer-0.17.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; qiskit_aer-0.17.2-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl
Keywords: qiskit, simulator, quantum computing, backend
Tags
More Scientific/Engineering packages
NumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
pandaspandas provides fast, flexible data structures…
permissive · top 100 on PyPI
scipyscipy provides numerical algorithms for…
permissive · top 100 on PyPI
scikit-learnscikit-learn provides a comprehensive Python…
permissive · top 1,000 on PyPI
dilldill extends Python's pickle module to…
permissive · top 1,000 on PyPI
multiprocessMultiprocess is an enhanced fork of Python's…
permissive · top 1,000 on PyPI
pyqirPyQIR generates, parses, and analyzes QIR…
permissive · top 15,000 on PyPI
qiskitQiskit is an open-source SDK for building and…
permissive · top 5,000 on PyPI
samplomaticSamplomatic generates randomized variants of…
permissive · top 15,000 on PyPI
amazon-braket-default-simulatorProvides a local quantum circuit simulator for…
permissive · top 15,000 on PyPI
qiskit-experimentsQiskit Experiments provides tools for building,…
permissive · top 15,000 on PyPI
cirq-coreCirq-core provides the foundational framework…
permissive · top 15,000 on PyPI
qiskit-algorithmsQiskit Algorithms provides a library of quantum…
permissive · top 15,000 on PyPI
qiskit-ionqQiskit IonQ Provider enables submission of…
permissive · top 15,000 on PyPI
qiskit-terraQiskit Terra provides the core SDK for building…
permissive · top 15,000 on PyPI
cirq-aqtCirq-AQT provides a Cirq integration that lets…
permissive · top 15,000 on PyPI