---
id: qiskit-qasm3-import
version: "0.6.0"
license: Apache 2.0 License
license_treatment: permissive
maintenance: active
---

# qiskit-qasm3-import — Importer for parsing OpenQASM 3 strings into Qiskit circuits

License: permissive · Maintenance: active · Downloads: 258.5K/mo

## What it is and what it does

This package provides a parser that converts OpenQASM 3 source code into Qiskit's QuantumCircuit representation. It accepts a complete OpenQASM 3 program as a string and returns a QuantumCircuit object ready for use in Qiskit workflows. The importer handles parametrized gates, gate modifiers, mathematical expressions, control flow (while loops, if/else), qubit aliasing, and measurement operations, as demonstrated in the documentation examples.

The package is designed as a temporary bridge: Qiskit itself optionally wraps this package's parse function as qiskit.qasm3.load and qiskit.qasm3.loads. The authors explicitly note this is a stop-gap solution until technical decisions can be resolved more permanently, meaning the API and feature set may evolve. It depends on qiskit and openqasm3, both of which must be installed.

Use it for:

- Convert existing OpenQASM 3 quantum programs into Qiskit circuits for execution on IBM quantum hardware or simulators
- Import parametrized quantum gate definitions and control flow from OpenQASM 3 files into Qiskit for circuit manipulation
- Migrate quantum algorithm code written in OpenQASM 3 to Qiskit-based workflows
- Parse OpenQASM 3 benchmark or reference circuits for testing and validation in Qiskit

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts OpenQASM 3 programs (as strings) into Qiskit QuantumCircuit objects, enabling quantum circuit construction from OpenQASM 3 source code.

Yes, if you need to work with OpenQASM 3 programs in Qiskit. Install friction is minimal, maintenance is active, and the license is permissive. However, note that the authors explicitly position this as a temporary solution pending technical decisions—expect the API or feature coverage to potentially change. No known vulnerabilities.

## Install

pip install qiskit-qasm3-import
uv add qiskit-qasm3-import
poetry add qiskit-qasm3-import

## Installing qiskit-qasm3-import

Before you install: Low install friction with only two runtime dependencies (qiskit and openqasm3). Package is actively maintained with a recent release (2025-06-10) and an active repository.

License in practice: Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install qiskit-qasm3-import

from qiskit_qasm3_import import parse

program = 'OPENQASM 3.0;\nqubit[2] q;\nmeasure q;'
circuit = parse(program)

Verify before relying:

- Whether the package supports all OpenQASM 3 features or only a subset of the specification
- Performance characteristics when parsing large or complex OpenQASM 3 programs
- Stability guarantees: the description notes this is a 'stop-gap measure' pending technical decisions

## Package facts

- License: Apache 2.0 License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 258.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

openqasm 3 to qiskit converter, qasm3 circuit importer, quantum circuit from openqasm, parse openqasm 3 strings, qiskit qasm3 loader, openqasm 3 parser qiskit, quantum-computing, circuit-conversion

[View on SkillFed](https://skillfed.io/packages/qiskit-qasm3-import) · [View on PyPI](https://pypi.org/project/qiskit-qasm3-import/)