Roadmap

Attention

From IBM to a Community-Maintained Project

Originally developed at IBM, originated by Dr. Zlatko K. Minev, Qiskit Metal has, over the past few years, transitioned into a community-driven project supported by multiple universities, research groups, laboratories, and individual contributors.

The v0.5 release (Dec. 2025) marks the formal graduation into this next phase of the project’s development. This version is still in beta, and is still being tested and validated, but it is updated with more modern packages and package managements, and fixes a number of issues.

Ongoing work is carried out by the Quantum Device Consortium (QDC), the broader community, and active maintainers, in close collaboration with Zlatko Minev and the contributors across QDW/QDC who are shaping this new chapter.

Note

Huge thanks to the v0.5 contributors (PR #1002): Sadman Ahmed Shanto, Abhishek Chakraborty, PositroniumJS, SamWolski, Nicolas Dirnegger, Eli Levenson-Falk, and Murat Can Sarıhan for testing, debugging, platform validation, and the PySide6 transition.

Near-term development roadmap:

Missing Image

Attention

We need input from you on what to prioritize and how to best shape so that Metal is useful to the wide community and hopefuly makes life easier for you too. Let us know through github issues, slack channel messages, or by telling us in one of the tutorials.

In the near future we aim to (see near-term roadmap image):

Legend:

✓ Completed ✰ Desired ✰✰✰ Highly desired

  • More quantum components

    • ✓ Tunable couplers (community-driven)

    • ✓ Flux & control lines & terminations

    • ✓ Routing manual-driven at 45 degrees, etc.

    • ✓ Wirebonds in rendering

    • ✓ Star qubit

    • ✓ Fluxonium (community-driven)

    • Add JJ layout component

      • ✓ Dolan single JJ

      • ✓ SQUID

      • Array

    • ✰✰ Cross-overs

    • Novel qubits (community-driven)

    • …

  • Add & enhance quantization analysis & ease of use
    • ✓ New lumped analysis code

      • More general couplers

      • ✰✰✰ WebApp

    • Sweeping parameters, optimetrics

      • ✓ for lumped analysis

      • ✓ for EPR analysis

      • for Z, S, Y analysis

    • ✰✰ Impedance quantization

      • Add fitting of Z curves & extraction of ZPF

    • ✰✰✰ pyEPR General potential - e.g. fluxonium

    • Improve ease of use & integration of pyEPR analysis

      • and dissipative EPR analysis

    • Better analysis interfaces and abstractions

    • …

  • Hamiltonian analysis
    • ✓ Pulse & gate analysis & time dynamics simulations 101

      • Advanced

    • ✓ Integration with quantum analysis packages: qiskit pulse, qutip (interested in listing your package here? Let us know :) ) 101

    • ✓ Integration with scQubits 101

  • Code & ease of use
    • Refactor and improve abstractions, interfaces, and data handling

      • Improved modularity of analysis

    • Develop ease of use and one-click solutions

    • More features in the GUI

      • ✓ Create components from the GUI library

      • ✓ Visual library with images

      • ✓ GUI to script

      • Including customization of coloring layers, plotting options, more interactive component editing

    • WebApp

  • Features you request!

    So, let us know in the Slack channel (#metal):)

  • Longer term:

    • Import from GDS ✰

    • Features you request! So, let us know in the Slack channel (#metal) :)

Qiskit Metal Workflow

Attention

This section is under construction.

Qiskit Metal enables chip prototyping in a matter of minutes. You can start from a convenient Python Jupyter notebook or take advantage of the user-friendly graphical user interface (GUI). Simply choose from a library of predefined quantum components, such as transmon qubits and coplanar resonators, and customize their parameters in real-time to fit your needs. Use the built-in algorithms to automatically connect components. Easily implement new experimental components using Python templates and examples.

Missing Workflow Diagram

Designing quantum devices is the bedrock of the quantum ecosystem, but it is a difficult, multi-step process that connects traditionally disparate worlds. Metal is automating and streamlining this process.

Missing Workflow Diagram

On the surface, designing a quantum chip should be a lot like designing any other integrated circuit. But a typical integrated circuit goes through a design flow process that’s had decades worth of tuning. As chips have scaled up in transistor count in step with Moore’s law, design tools have matured in kind, becoming automated. Today, a sequence of programs allow chip designers to think in a modular way about integrated circuits with billions of transistors, in a process that rather seamlessly creates and tests designs, then moves them to the fabrication stage. Quantum computers are not like today’s computer microprocessors, though. Quantum bits are much larger than transistors, and require more complex superconducting circuitry. Computer-aided electronic design automation software covers only some parts of this intricate fabrication process, and using these software packages to design a quantum computer comes with a high barrier to entry. In terms of a high-level description, we aim to perform the following tight feedback loop of design. (read the full Medium blog)

Missing Image


Quantization Methods Overview

We currently support two complementary quantization approaches that cover most day-to-day chip design work: a lightweight lumped/ quasi-lumped model and a full-wave, black-box style energy-participation ratio (EPR) workflow. Use this section as a quick “why and when” guide before you pick a solver.

What you give us - Your device geometry (from the QComponent library or your own components) - A small set of materials/stack assumptions (dielectrics, metal films, boundaries) - The excitation/ports you care about (for scattering or eigenmode solves)

What you get back - Modal frequencies, anharmonicities, and dispersive shifts - Coupling strengths and participation matrices you can plug into Hamiltonians - Loss estimates tied to specific volumes (dielectrics, conductors, seams) so you can chase the right bottleneck

Each method balances speed, fidelity, and required setup. Start with the lumped model when you need fast iteration and intuitive circuit pictures; switch to EPR when geometry and field participation really matter.

Missing Image

Lumped-oscillator model

In the lumped-oscillator model you treat each component as a compact circuit element whose capacitance and inductance can be extracted from fast quasi-static simulations or closed-form formulas. Think of it as a guided way to draw a circuit, pull out the C and L values, and then stitch those into a Hamiltonian.

When to use it. Early design and parameter sweeps when you want intuition and speed. Routing, connector placement, and first-order coupling strengths are often “good enough” here. Because solves are cheap, you can explore a lot of geometry/stack variants before moving to heavier solvers.

How it works. Partition the device into a handful of cells, solve each one quickly to get effective C/L values, then assemble the network and quantize. The reduction step preserves the pairwise couplings so you keep track of renormalization and loading. The result is a simple Hamiltonian with parameters you can iterate on in minutes.

References:

  • Zlatko K. Minev, Thomas G. McConkey, Maika Takita, Antonio Corcoles, Jay M. Gambetta, Circuit quantum electrodynamics (cQED) with modular quasi-lumped models. (2021)

Missing Image Missing Image

Energy: The energy-participation-ratio (EPR) method

The energy-participation-ratio (EPR) method is a general (black-box) quantization method. Based on the Qiskit Metal integration with pyEPR, one can automate the design and quantization of Josephson quantum circuits, and even 3D circuits.

The EPR method is based on the energy-participation ratio (EPR) of a dissipative or nonlinear element in an electromagnetic mode. The EPR, a number between zero and one, quantifies how much of the energy of a mode is stored in each element. It obeys universal constraints—valid regardless of the circuit topology and nature of the nonlinear elements. The EPR of the elements are calculated from a unique, efficient electromagnetic eigenmode simulation of the linearized circuit, including lossy elements. Their set is the key input to the determination of the quantum Hamiltonian of the system. The method provides an intuitive and simple-to-use tool to quantize multi-junction circuits. It is especially well-suited for finding the Hamiltonian and dissipative parameters of weakly anharmonic systems, such as transmon qubits coupled to resonators, or Josephson transmission lines. The EPR method is experimentally tested on a variety of Josephson circuits, and demonstrated high agreement for nonlinear couplings and modal Hamiltonian parameters, over many order of magnitude in energy.

When to use it. When layout details matter: packaging effects, higher-mode participation, junction placement, seams, or substrate losses. EPR gives you a field-aware Hamiltonian and ties every loss number to a physical volume, so you know which lever to pull next.

What you set up. Draw your design, define materials and boundaries, place ports, and run a single eigenmode solve on the linearized circuit. pyEPR reads the fields, computes participations for every nonlinear/lossy element, and hands back frequencies, dispersive shifts, anharmonicities, and loss budgets. Because it is black-box, it scales to multi-mode, multi-junction systems with minimal hand-tuning.

References:

Impedance: impedance-based black-box quantization (BBQ)

The impedance formulation of black-box quantization builds the Hamiltonian directly from the frequency-dependent impedance seen between nonlinear elements and ground. It shares the “full-wave fields first, circuit later” philosophy of EPR, but works in the impedance domain: from a port-defined impedance matrix you extract effective mode frequencies, participation factors, and couplings.

When to use it. For strongly multi-port/multi-mode layouts where port impedances are the most natural handle (e.g., rich bus networks, Purcell filters, or chip-package assemblies). It is also a good cross check to EPR when you want to validate couplings via an independent pipeline.

What you set up. Define ports at the locations of junctions or pins, run an eigenmode or driven solve to obtain the impedance matrix versus frequency, then sample around the modes of interest. The resulting impedances map to effective inductive/capacitive participations and give you the Hamiltonian parameters.

Outputs. Mode frequencies, nonlinear participation, and cross-Kerr rates derived from the impedance matrix, plus a clear picture of how design changes move those impedances. Use it to tune Purcell filters, set coupling windows, or debug unexpected mode crowding.

Missing Image

Impedance: impedance-based black-box quantization (BBQ)

“A semiclassical method for determining the effective low-energy quantum Hamiltonian of weakly anharmonic superconducting circuits containing mesoscopic Josephson junctions coupled to electromagnetic environments made of an arbitrary combination of distributed and lumped elements. A convenient basis, capturing the multimode physics, is given by the quantized eigenmodes of the linearized circuit and is fully determined by a classical linear response function.” Nigg et al. (2012).

References:

  • Nigg, S. E., Paik, H., Vlastakis, B., Kirchmair, G., Shankar, S., Frunzio, L., … Girvin, S. M. (2012). Black-Box Superconducting Circuit Quantization. Physical Review Letters, 108(24), 240502. https://doi.org/10.1103/PhysRevLett.108.240502

  • Bourassa, J., Beaudoin, F., Gambetta, J. M., & Blais, A. (2012). Josephson-junction-embedded transmission-line resonators: From Kerr medium to in-line transmon. Physical Review A, 86(1), 013814. https://doi.org/10.1103/PhysRevA.86.013814

  • Solgun, F., Abraham, D. W., & DiVincenzo, D. P. (2014). Blackbox quantization of superconducting circuits using exact impedance synthesis. Physical Review B, 90(13), 134504. https://doi.org/10.1103/PhysRevB.90.134504

Missing Image