Learn

The tutorial course, in four parts. Each part lists its notebooks in the order to read them. New here? Start with the Quick start page, then Part 1, or pick a goal on Choose your path.

The four parts

Part 1: First steps

Place a component, build a four-qubit chip, save it, iterate on it. (5 notebooks)

Part 1: First steps
Part 2: From components to chip

QComponents, routing, a full chip, and your own QComponent. (16 notebooks)

Part 2: From components to chip
Part 3: Render and export

Export to GDS, mesh with gmsh, render to Ansys, write a renderer. (5 notebooks)

Part 3: Render and export
Part 4: Simulate and analyze

Open-source and Ansys simulation, then circuits to Hamiltonians. (26 notebooks)

Part 4: Simulate and analyze

Also: Examples (components and reference designs to copy) and Research showcase: published devices and results, reproduced (published devices and results).

Click for Video Tutorials

External Workshops

Independently-maintained workshop materials that exercise Quantum Metal end-to-end (layout → simulation → analysis) using open-source EM solvers via SQDMetal.

  • QDW 2025 — tutorials_quantum_device_design (historical, Metal pre-v0.5) — 4 notebooks covering layout, transmon+resonator, qubit-qubit coupling, and an end-to-end project, simulated with Palace via SQDMetal.

  • QDW 2026 — qdw26-workshop-materials (active, near-mainline Metal) — Dockerized re-tooling of the same 4-notebook progression. Shared uv environment, JupyterLab + VS Code attach paths, Brev / cloud-instance support.