File size: 2,216 Bytes
a7790b0 c9245b6 a7790b0 | 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 | ---
title: QuPrep
emoji: ⚡
colorFrom: blue
colorTo: purple
sdk: gradio
pinned: true
license: apache-2.0
thumbnail: >-
https://cdn-uploads.huggingface.co/production/uploads/6390b2d90aea681d3f3fd6b7/wZZeHlOwjImqGL6xBG65U.png
---
# QuPrep — Quantum Data Preparation
**The missing preprocessing layer between classical datasets and quantum computing.**
QuPrep converts classical tabular datasets into quantum-circuit-ready format. It sits between your data and whichever quantum framework you use — Qiskit, PennyLane, Cirq, TKET, Amazon Braket, Q#, or IQM — without locking you into any one of them.
Think of it as the **pandas of quantum data preparation**: focused, composable, framework-agnostic.
```
CSV / DataFrame / NumPy → QuPrep → circuit-ready output for your framework
```
## What it does
- **11 encoding methods** — Angle, Amplitude, Basis, IQP, Entangled Angle, Data Re-uploading, Hamiltonian, ZZFeatureMap, PauliFeatureMap, Random Fourier, Tensor Product
- **8 export targets** — Qiskit, PennyLane, Cirq, TKET, Amazon Braket, Q#, IQM, OpenQASM 3.0
- **Intelligent recommendation** — dataset-aware encoding selection with ranked alternatives
- **Hardware-aware reduction** — auto-reduces features to fit a backend's qubit budget
- **QUBO / Ising** — formulate and solve combinatorial optimization problems (Max-Cut, TSP, Knapsack, Portfolio, and more)
- **Plugin registry** — register custom encoders and exporters that work with the same one-liner API
## Install
```bash
pip install quprep
```
## Quick example
```python
import quprep as qd
result = qd.prepare("data.csv", encoding="angle", framework="qiskit")
print(result.circuit) # qiskit.QuantumCircuit
print(result.cost) # gate count, depth, NISQ safety
```
## Links
- 📦 PyPI: [pypi.org/project/quprep](https://pypi.org/project/quprep/)
- 📖 Docs: [docs.quprep.org](https://docs.quprep.org)
- 🌐 Website: [quprep.org](https://quprep.org)
- 💻 Source: [github.com/quprep/quprep](https://github.com/quprep/quprep)
- 🎯 Demo: [huggingface.co/spaces/quprep/demo](https://huggingface.co/spaces/quprep/demo)
---
*Apache 2.0 license · Python ≥ 3.10 · Independent research project* |