SQuADDS#
A validated design database and simulation workflow for superconducting qubits
SQuADDS gives you a well-characterised starting point for superconducting hardware. Ask for the Hamiltonian you want and get the closest pre-simulated designs from an experimentally validated database, an interpolated best guess, and, from version 0.5, the full capacitance matrix of any planar layout straight from its GDS file.
pip install SQuADDSPython 3.11 or newer. For the capacitance models: pip install "squadds[ml]". From source with uv sync: installation guide.
Where to start#
Qubit designers
Find a design for your Hamiltonian
Give target parameters, get the closest pre-simulated designs and an interpolated best guess to simulate.
db = SQuADDS_DB()
db.select_system("qubit")
db.select_qubit("TransmonCross")
db.create_system_df()
Analyzer(db).find_closest(
{"qubit_frequency_GHz": 4,
"anharmonicity_MHz": -200}, num_top=3)
Layout to capacitance
Capacitance matrix from a GDS file
The full N × N Maxwell matrix of every conductor, ground included, in about a second on a CPU. Nets are never merged.
predictor = CapacitancePredictor(
load_model("QCap"))
res = predictor.predict("chip.gds")
res.to_dataframe() # fF, ground first
Contributors
Add your designs and data
Simulated or measured devices, capacitance data and models. The validator checks every matrix before a pull request opens.
validate_capacitance_contribution(
"my_batch/")
contribute_capacitance("my_batch/")
AI agents
Connect an assistant with MCP
The SQuADDS MCP server lets a coding assistant search designs, find the closest match and interpolate parameters.
uv sync --extra mcp
uv run squadds-mcp
Learn more about our latest paper#
Tutorials#
Contents#
Getting started: set up SQuADDS and start using it.
Tutorials: step-by-step guides for common workflows.
MCP server: connect AI coding assistants to the SQuADDS database.
ML models: planar capacitance models and the hosted inference models on Hugging Face.
Run ML models locally: the capacitance models on your own computer.
API reference: the full API documentation.
Contribution portal: contribute to SQuADDS in seconds.
Contributing: get involved in the development of SQuADDS.
Developer notes: insights and guidelines for developers.
Simulation notes: how our simulations are set up.
Workflows: the key workflows within SQuADDS.
Release notes: updates and new releases.
Chat with the codebase: ask DeepWiki about the code.
Indices: Index, Module Index, Search Page.
Citing SQuADDS and QCap#
If SQuADDS helps your research, please support its continued development and maintenance by citing the paper: Shanto et al., Quantum 8, 1465 (2024). If you use QCap (the planar capacitance models or their dataset), please also cite Shanto, Das and Levenson-Falk (2026).
@article{Shanto2024squaddsvalidated,
doi = {10.22331/q-2024-09-09-1465},
url = {https://doi.org/10.22331/q-2024-09-09-1465},
title = {{SQ}u{ADDS}: {A} validated design database and simulation workflow for superconducting qubit design},
author = {Shanto, Sadman and Kuo, Andre and Miyamoto, Clark and Zhang, Haimeng and Maurya, Vivek and Vlachos, Evangelos and Hecht, Malida and Shum, Chung Wa and Levenson-Falk, Eli},
journal = {{Quantum}},
issn = {2521-327X},
publisher = {{Verein zur F{\"{o}}rderung des Open Access Publizierens in den Quantenwissenschaften}},
volume = {8},
pages = {1465},
month = sep,
year = {2024}
}
@misc{Shanto2026planarcapacitance,
title = {{QCap}: a physics-corrected graph neural network for the capacitance matrix of any planar superconducting device layout},
author = {Shanto, Sadman Ahmed and Das, Saikat and Levenson-Falk, Eli},
year = {2026},
url = {https://lfl-lab.github.io/SQuADDS/ml-paper/paper/}
}