QForge: Quantum Simulation Toolkit

QForge is a comprehensive, terminal-based quantum simulation toolkit that bridges qubit physics to hardware design. Built for everyone from absolute beginners to seasoned quantum computing researchers.

🚀 Features

✅ Fully Implemented

• Qubit Physics Modeling: Transmon, Fluxonium, Flux, Zero-π with pre-configured parameters
• Gate Physics Simulation: Time-domain simulation of single-qubit gates (X, Y, Z, H) using QuTiP dynamics.
• Terminal Plotting: Visualize energy spectra and Rabi oscillations directly in your terminal.
• Comprehensive Analysis: Energy spectra, coherence times (T1, T2), parameter sweeps.
• Realistic Noise Modeling: Accurate coherence time estimates and relaxation dynamics.
• Interactive CLI: Beginner-friendly wizards with auto-completions and rich visualizations.
• Comparison Engine: Compare different qubit architectures side-by-side.

🚧 Coming Soon

• Circuit Simulation: Multi-qubit circuit simulation with Qiskit
• Hardware Design: Chip layout design with Qiskit Metal
• Plugin Architecture: Extensible system for custom qubits and components

📦 Installation

pip install qforge

Development Installation

git clone https://github.com/Ingenio17/qforge.git
cd qforge
pip install -e ".[dev]"

🎯 Quick Start

Interactive Mode (Recommended)

qforge --interactive

1. Create a Qubit

qforge qubit create transmon --name my_qubit --EJ 15 --EC 0.3

2. Analyze Spectrum

View energy levels directly in your terminal:

qforge qubit analyze --name my_qubit --plot

3. Simulate a Gate

Simulate a $\pi$-pulse (X gate) and view Rabi oscillations:

qforge gate simulate --qubit my_qubit --gate X --duration 40 --save

📚 Documentation

Full documentation is available at qforge.readthedocs.io.

• Getting Started
• Examples

🎓 Examples

Check out the examples/ directory for complete workflows:

• gate_simulation.py: End-to-end gate dynamics simulation.
• transmon_workflow.py: Complete transmon simulation and analysis.
• fluxonium_workflow.py: Complete fluxonium simulation and analysis.
• comprehensive_comparison.py: Advanced multi-qubit comparison with reports.

🏗️ Architecture

QForge is built on industry-standard quantum libraries:

• scqubits: Superconducting qubit physics
• QuTiP: Quantum dynamics and gate simulation
• Qiskit: Circuit-level quantum computing
• Qiskit Metal: Quantum hardware chip design

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide.

Acknowledgments

QForge relies on the following open-source projects:

• scqubits: Setup and simulation of superconducting qubits.
  • Copyright (c) 2019 and later, Jens Koch and Peter Groszkowski. Licensed under BSD 3-Clause.
• QuTiP: Quantum Toolbox in Python for dynamics.
  • Copyright (c) 2011-2022 QuTiP developers. Licensed under BSD 3-Clause.
• Qiskit: Quantum SDK for circuit simulation.
  • Copyright IBM Corporation and others. Licensed under Apache 2.0.
• Qiskit Metal: Hardware design.
  • Copyright Qiskit Metal Development Team. Licensed under Apache 2.0.

Please see NOTICE and ThirdPartyNotices.md for full license details.

📄 License

Apache License 2.0 - see LICENSE for details.