QFoundry is a premium, interactive development suite for Qiskit built directly into VS Code. It provides real-time visualization, gate-by-gate debugging, local execution histograms, and comprehensive hover documentation to speed up your quantum computing workflow.

Features

1. 🔍 Live Circuit Preview

No need to run your script to see if you built the circuit correctly. As you write code, QFoundry parses the source and renders a vector-perfect SVG diagram of your circuit in a side panel. It updates automatically on every keypress (debounced).

2. 🐛 Interactive Circuit Debugger

A professional-grade debugger built specifically for quantum state exploration:

Timeline Controls: Play, pause, step forward/backward, and scrub through gate sequences.
Gate Highlighting: Click any gate on the timeline sidebar to jump execution directly to that step.
Statevector Analysis: View the exact complex amplitudes, real/imaginary parts, and outcome probabilities at each step.
HSL Phase Disks: Visualize quantum phase angles ($\theta$) in real-time using custom SVG-based phase disks mapped to an HSL color-wheel.

3. 📊 Local Quantum Simulation & Histograms

Simulate your circuit locally directly from the panel:

Supports custom shots count and random seed presets.
Visualizes basis state measurements in a beautiful interactive histogram with hover details.
Automatically injects measure_all() if you forget to add measurements.

4. 📚 Smart Hover Documentation

Get instant math and code references offline:

Hovering over any gate method (e.g. h, cx, rx, t) in Python displays a rich documentation card.
Details include mathematical matrices, physical intuition, typical use cases, code examples, and related gates.

5. 🧠 Circuit Analyzer & Pattern Explainer

Static analysis that automatically identifies circuit characteristics:

Reports width, depth, total gate counts, and two-qubit gate counts.
Analyzes structure to recognize known algorithms and states (such as Bell State, GHZ State, Quantum Teleportation, Superposition, and VQE).

How to Use

Open a Python file containing a Qiskit circuit (e.g., qc = QuantumCircuit(2)).
Click the Visualize Circuit icon in the editor toolbar (top-right) or press Ctrl + Shift + Q (Cmd + Shift + Q on macOS).
The preview panel will slide in:
- Use Preview to see the circuit diagram.
- Switch to Debugger to step through the statevector step-by-step.
- Switch to Simulation to configure and run local sampling.
- Switch to Explain to see depth/gate counts and algorithmic patterns.

Requirements & Prerequisites

Python 3.8+
Qiskit (Install via pip install qiskit)
(Optional) Qiskit Aer for fast local simulation (Install via pip install qiskit-aer)