Update README.md

README.md

@@ -1,10 +1,60 @@
----
-title: README
-emoji: 🌍
-colorFrom: purple
-colorTo: blue
-sdk: static
-pinned: false
+---
+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)
+
 ---
 
-Edit this `README.md` markdown file to author your organization card.
+*Apache 2.0 license · Python ≥ 3.10 · Independent research project*