qiskit-terra

library0.46.3pypypi✓ verified 87d ago

Qiskit is an open-source SDK for working with quantum computers at the level of circuits, transpilation, and pulse control. The qiskit-terra package is the foundational component, providing circuit construction, transpilation, simulation, and IBM Quantum backend access. As of version 2.x, the package is simply called 'qiskit' on PyPI (qiskit-terra is a legacy distribution). Current version: 2.4.1, with quarterly releases.

ai-ml

pip install qiskit

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · QISKIT-TERRA

qiskit-terra

ai-mlpythonv0.46.3

Install

12.7s avg

Import

1964ms

Disk

478MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.46.3 · 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

musl

py 3.10–3.910 runs

build_error

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 12.7s · import 1.964s · 461MB

478MB installed

● package 478MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

QuantumCircuit

✓ from qiskit import QuantumCircuit

✗ from qiskit-terra import QuantumCircuit

qiskit-terra is not a package; use qiskit

transpile

✓ from qiskit import transpile

✗ from qiskit.compiler import transpile

removed in Qiskit 1.0

Aer

✓ from qiskit_aer import Aer

✗ from qiskit import Aer

Aer was removed from qiskit-terra in 0.44; install qiskit-aer separately

plot_histogram

✓ from qiskit.visualization import plot_histogram

✗ from qiskit.tools.visualization import plot_histogram

qiskit.tools removed in Qiskit 1.0

Create a Bell state circuit and transpile for the built-in basic simulator.

from qiskit import QuantumCircuit from qiskit import transpile from qiskit.providers.basic_provider import BasicProvider # Create a simple circuit qc = QuantumCircuit(2) qc.h(0) qc.cx(0, 1) qc.measure_all() # Transpile for basic simulator qc = transpile(qc, backend=BasicProvider().get_backend('basic_simulator')) print(qc)

qiskit --version

Debug

Known issues

breakingQiskit 1.0 removed many legacy modules: qiskit.tools, qiskit.quantum_info.random, qiskit.extensions, and more. Update imports and usage accordingly.

fix

Refer to the Qiskit 1.0 migration guide: https://docs.quantum.ibm.com/migration-guides/v1

affects: >=1.0.0

deprecatedQiskit 2.x deprecated the use of the Qiskit Terra PyPI package name; use `qiskit` instead.

fix

Install via `pip install qiskit` (qiskit-terra may be for legacy compatibility only).

affects: >=2.0.0

gotchaAer is no longer part of qiskit-terra. Importing from qiskit.providers.aer will fail. You must install qiskit-aer separately.

fix

pip install qiskit-aer and import from qiskit_aer

affects: >=0.44.0

gotchaThe BasicAer backend was removed in Qiskit 1.0. Use BasicProvider from qiskit.providers.basic_provider instead.

fix

from qiskit.providers.basic_provider import BasicProvider

affects: >=1.0.0

deprecatedQuantumCircuit.draw() with the 'mpl' style may require matplotlib to be installed separately.

fix

pip install matplotlib, or use 'text' style

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'qiskit'

Qiskit is not installed.

fix

pip install qiskit

ModuleNotFoundError: No module named 'qiskit.extensions'

qiskit.extensions was removed in Qiskit 1.0.

fix

Import gates directly: from qiskit.circuit.library import HGate, CXGate

ImportError: cannot import name 'Aer' from 'qiskit'

Aer was moved to a separate package in qiskit-terra 0.44.

fix

pip install qiskit-aer and import from qiskit_aer

AttributeError: 'QuantumCircuit' object has no attribute 'qasm'

The qasm() method was removed in Qiskit 1.0.

fix

Use qiskit.qasm2.dumps(circuit) or qiskit.qasm3.dumps(circuit)

Upgrade

Version history

0.46.3latest on PyPI · released Sep 26, 2024

Audit

Dependencies

numpyrequiredCore dependency for array operations

rustworkxrequiredGraph library used for DAG circuits

symenginerequiredSymbolic expression handling (ParameterExpression)

Agent activity

10 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/Qiskit/qiskit ↗

packagehttps://pypi.org/project/qiskit-terra/ ↗

homepagehttps://www.ibm.com/quantum/qiskit ↗

docshttps://docs.quantum.ibm.com ↗

changeloghttps://docs.quantum.ibm.com/api/qiskit/release-notes ↗