File size: 3,092 Bytes
6cc6c7f |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 |
---
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}
}
--- |