Skip to content

Latest commit

 

History

74 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SpudQ: Quantum Circuit Tooling Suite

Python 3.10+ GUI Framework: PyQt6 Status: Active Development

SpudQ is a localized quantum tool-suite designed to create, transpile, and benchmark quantum circuitry.


Program Preview

Note: 'Qreator' is still currently in active development.

Adding gates to the qubit rails.

You can see the full program in action here


System Architecture

SpudQ is designed as a three module pipeline:

First Phase: The Qreator [REFACTORING]

An interactive PyQt6 program for creating quantum circuits in a visual diagram, manage the hardware topology, and save/load the circuitry.

Second Phase: The Transpiler [TBD]

A compilation engine designed to reduce redundant gates, and optimize the circuitry for the expected hardware topology.

Third Phase: The Benchmarker [TBD]

A diagnostic tool to calculate the execution time, circuit depth, and memory overhead across varying qubit count into a standardized score.


Installation & Quickstart

Prerequisites

  • Python 3.10 or higher

Setup & Launch

These commands are natively for Linux systems.

# Clone the repo.
git clone https://codeberg.org/SpudWorks/SpudQ
cd SpudQ

# Create and activate the virtual environment.
python3 -m venv .spudq
source .spudq/bin/activate

# Install dependencies
pip install -r requirements.txt

# Enter the src directory for simple execution.
cd src

# Launch the 'Qreator' program with a new circuit.
python main.py qreator

Tech Stack

  • Language: Python
  • GUI Engine: PyQt6
  • Circuit Modeling: Internal data structures for representing the necessary information.

Roadmap & Phase Status

Phase 1: Qreator UI Core [CURRENT]

  • Custom PyQt6 circuit grid and wire rendering.
  • Single qubit gates.
  • Save/Load circuit states.
  • Multi qubit gates.
  • OpenQASM 3.0 parser. (Circuit/Gate Subset)
  • Tri-plus qubit gates. (Optional, future feature.)

Phase 2: Transpilation Engine

  • Redundant gate removal.
  • Gate conversion and optimization.
  • Matrix verification.

Phase 3: Benchmarker & CLI

  • Circuit depth analysis module.
  • Automated profiling CLI tool.

Important Acknowledgements

This project is made solely by Human Developers using AI Tooling.

About

A simple, local quantum tooling suite for creating, transpiling, and benchmarking circuits for quantum hardware.

Resources

Code of conduct

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages