Install & Compatibility
Where this runs
tested against v0.4.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
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 9.0s · import 3.374s · 266MB
270MB installed
● package 270MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
VQE
✓ from qiskit_algorithms import VQE
✗ from qiskit.algorithms import VQE
In Qiskit 0.25+ algorithms moved to standalone package. Importing from qiskit.algorithms is deprecated and will break in Qiskit 1.0+.
QAOA
✓ from qiskit_algorithms import QAOA
✗ from qiskit.algorithms import QAOA
Same as above; all algorithm classes moved to qiskit_algorithms.
Grover
✓ from qiskit_algorithms import Grover
AmplitudeEstimation
✓ from qiskit_algorithms import AmplitudeEstimation
A minimal example of Grover's search with the standalone qiskit-algorithms package.
from qiskit import QuantumCircuit
from qiskit.primitives import StatevectorSampler
from qiskit_algorithms import Grover
from qiskit_algorithms.amplitude_amplifiers import GroverOperator
# Define a simple oracle for |11>
oracle = QuantumCircuit(2)
oracle.cz(0, 1)
# Grover operator
grover_op = GroverOperator(oracle)
# Grover instance
sampler = StatevectorSampler()
grover = Grover(sampler=sampler)
# Run Grover's algorithm
result = grover.amplify(grover_op)
print("Top measurement:", result.top_measurement)
Debug
Known issues
gotchaPost-Qiskit 1.0, `qiskit.algorithms` is removed entirely. Use `qiskit-algorithms` standalone package.fixReplace `from qiskit.algorithms import ...` with `from qiskit_algorithms import ...` and ensure qiskit-algorithms is installed.
affects: qiskit >=1.0, qiskit-algorithms <0.3.0 (no support); use qiskit-algorithms >=0.3.0
breakingPrimitivesV2 support in 0.4.0 changes the API: algorithms now accept sampler/estimator V2 instances (e.g., StatevectorSampler) instead of V1 (e.g., Sampler).fixUpdate primitive references: `from qiskit.primitives import StatevectorSampler` instead of `from qiskit.primitives import Sampler`.
affects: qiskit-algorithms 0.4.0+
deprecated`qiskit.algorithms` module (in qiskit-terra) is deprecated since Qiskit 0.25 and removed in Qiskit 1.0.fixInstall qiskit-algorithms and change imports to `qiskit_algorithms`.
affects: qiskit 0.25 - 0.46, qiskit 1.0+
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'qiskit.algorithms'
Qiskit 1.0+ removed the algorithms module. Use the standalone package.
fixpip install qiskit-algorithms, then change imports to `from qiskit_algorithms import ...`
TypeError: VQE.__init__() got an unexpected keyword argument 'ansatz'
In qiskit-algorithms 0.3+, the VQE constructor changed: use `estimator` and `optimizer` keyword, not `ansatz` directly.
fixUse VQE(estimator, ansatz, optimizer) with required positional arguments: VQE(estimator, ansatz, optimizer). Check docs for correct signature.
AttributeError: module 'qiskit_algorithms' has no attribute 'NumPyMinimumEigensolver'
Some algorithms moved to submodules in later versions.
fixUse `from qiskit_algorithms.minimum_eigensolvers import NumPyMinimumEigensolver`.
Upgrade
Version history
0.4.0latest on PyPI · released Aug 29, 2025
Audit
Dependencies
qiskitrequiredCore Qiskit dependency for quantum circuit construction, transpilation, and primitives.
scipyoptionalUsed for classical optimizers (e.g., SLSQP) in VQE.
numpyrequiredNumerical computations backend.