| --- |
| license: mit |
| language: |
| - en |
| tags: |
| - nvidia |
| - cuda |
| - gpu |
| - quantum |
| - prototypes |
| - bencmark |
| - H100 |
| - cuquantum |
| - tensor-cores |
| --- |
| license: mit |
| tags: |
| - nvidia |
| - cuda |
| - gpu |
| - quantum |
| - prototypes |
| - benchmarks |
| - h100 |
| - cuquantum |
| - tensor-cores |
| datasets: |
| - custom |
| metrics: |
| - gpu-utilization |
| - tflops |
| - memory-usage |
| --- |
|
|
| # QuantumFlow — GPU-Accelerated Prototypes Ecosystem |
|
|
| ## Model Summary |
|
|
| QuantumFlow is a collection of three GPU-first prototypes designed to run together in one environment, demonstrating reproducible GPU validation, cuQuantum acceleration, and ecosystem compatibility. |
|
|
| **Achieving 95%+ GPU utilization on NVIDIA H100 with reproducible benchmarks.** |
|
|
| ## Key Results (tested on NVIDIA H100 PCIe) |
|
|
| | Component | What it proves | Key metric | Evidence | |
| |---|---|---:|---| |
| | Team1 Quantum | Tensor Core-heavy screening workload (CPU fallback) | NVML GPU util avg **95.19%** | `prototypes/team1_quantum/benchmarks/results/latest.json` | |
| | Team2 Energy | Differentiable thermo + grid optimization (CPU fallback) | NVML GPU util avg **95.44%** | `prototypes/team2_energy/benchmarks/results/latest.json` | |
| | Team3 Innovation | cuQuantum contraction + sustained soak | NVML GPU util avg **95.47%** + `cuquantum_used=true` | `prototypes/team3_innovation/benchmarks/results/latest.json` | |
|
|
| ## Quick Start |
|
|
| ### Installation |
|
|
| ```bash |
| # CPU (no CUDA required) |
| python -m pip install -U pip |
| python -m pip install -r prototypes/requirements.cpu.txt |
| |
| # NVIDIA GPU (CUDA 12, without cuQuantum) |
| python -m pip install -U pip |
| python -m pip install -r prototypes/requirements.gpu-cu12.txt |
| |
| # NVIDIA GPU (CUDA 12) + cuQuantum (Team3 acceleration) |
| python -m pip install -U pip |
| python -m pip install -r prototypes/requirements.gpu-cu12-cuquantum.txt |
| ``` |
|
|
| ### Run Ecosystem Smoke Test |
|
|
| ```bash |
| python prototypes/ecosystem_smoke.py |
| ``` |
|
|
| ### Run Individual Prototypes |
|
|
| ```bash |
| # Team1 Quantum |
| python prototypes/team1_quantum/demo/demo.py |
| python prototypes/team1_quantum/benchmarks/run_benchmarks.py |
| |
| # Team2 Energy |
| python prototypes/team2_energy/demo/demo.py |
| python prototypes/team2_energy/benchmarks/run_benchmarks.py |
| |
| # Team3 Innovation |
| python prototypes/team3_innovation/demo/demo.py |
| python prototypes/team3_innovation/benchmarks/run_benchmarks.py |
| ``` |
|
|
| ## NVIDIA Technologies Used |
|
|
| - CUDA 12.x (PyTorch CUDA) |
| - Tensor Cores (BF16/FP16 matmul soak) |
| - NVML (`nvidia-ml-py`) for utilization/memory metrics |
| - cuQuantum (Team3 only): `cutensornet` / `tensornet` contractions + `custatevec` |
|
|
| ## Links |
|
|
| - GitHub Repository: https://github.com/Corusant-world/quantumflow-prototypes |
| - Documentation: https://github.com/Corusant-world/quantumflow-prototypes/blob/main/README.md |
| - Docker Images: https://github.com/Corusant-world/quantumflow-prototypes/pkgs/container/quantumflow |
| - Release Notes: https://github.com/Corusant-world/quantumflow-prototypes/releases/tag/v0.1.1 |
|
|
| ## Citation |
|
|
| ```bibtex |
| @software{quantumflow2025, |
| author = {Corusant-world}, |
| title = {QuantumFlow: GPU-Accelerated Prototypes Ecosystem}, |
| year = {2025}, |
| url = {https://github.com/Corusant-world/quantumflow-prototypes} |
| } |
| --- |
