quanta-sdk 0.4.0__tar.gz

quanta_sdk-0.4.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Download artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.12.4
+        with:
+          attestations: false

quanta_sdk-0.4.0/.github/workflows/tests.yml

@@ -0,0 +1,30 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --tb=short -q

quanta_sdk-0.4.0/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+venv/
+env/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test / Coverage
+.pytest_cache/
+htmlcov/
+.coverage
+.tox/
+
+# Distribution
+*.whl
+*.tar.gz

quanta_sdk-0.4.0/CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog
+
+All notable changes to Quanta SDK.
+
+Format: [Semantic Versioning](https://semver.org/)
+
+---
+
+## [v0.4.0] - 2026-03-06
+
+### Added — Real-World Applications
+- **VQE**: Variational Quantum Eigensolver (`layer3/vqe.py`)
+  - Hardware-efficient ansatz, parameter-shift gradients
+  - H2: 100.00% accuracy, HeH+: 99.99% accuracy
+- **Shor's Algorithm**: Integer factoring (`layer3/shor.py`)
+  - QFT-based period finding, continued fractions
+  - 15 = 3 × 5 verified
+- **QSVM**: Quantum Support Vector Machine (`layer3/qsvm.py`)
+  - ZZFeatureMap kernel, quantum-enhanced classification
+  - 100% accuracy on linearly separable data
+- **Hamiltonian Simulation**: (`layer3/hamiltonian.py`)
+  - Trotterized time evolution
+  - Pre-defined molecules: H2, LiH, HeH+
+- **Portfolio Optimization**: (`layer3/finance.py`)
+  - Markowitz mean-variance → QUBO, QAOA-inspired selection
+  - Conservative vs aggressive profiles, Sharpe ratio
+- **Surface Code**: (`qec/surface_code.py`)
+  - [[d²,1,d]] logical qubits, error correction simulation
+  - Threshold ~1%, error suppression verified
+- **BB84 QKD Protocol**: Quantum key distribution (`examples/08_qkd_bb84.py`)
+  - Eavesdropper detection via ~25% error rate
+
+### Added — Benchmark Infrastructure
+- **QASM Import**: (`export/qasm_import.py`)
+  - Full QASM 2.0/3.0 → DAG parser
+  - Registers, parametric gates, pi expressions
+- **QASMBench Suite**: (`benchmark/qasmbench.py`)
+  - 10 standard circuits: bell, ghz, qft, teleportation, deutsch-jozsa, grover, adder, vqe_ansatz, swap_test, random_10
+  - Full pipeline benchmark: import → compile → simulate → metrics
+  - 10/10 circuits pass
+- **Benchpress Adapter**: (`benchmark/benchpress_adapter.py`)
+  - `QuantaBenchpressBackend` compatible with Nation et al. framework
+  - new_circuit, apply_gate, optimize, export_qasm, simulate
+
+### Added — Demo Cases
+- `06_molecule_energy.py` — H2 + HeH+ ground state (VQE)
+- `07_portfolio_optimization.py` — Tech stocks + crypto portfolio
+- `08_qkd_bb84.py` — Quantum Key Distribution
+- `09_full_demo.py` — All features in one script
+- `10_quantum_benchmark.py` — 8-test quality litmus test
+
+### Tests
+- 52 new test cases → **150 total** (was 98)
+- `test_layer3_new.py`: VQE, Shor, QSVM, finance, hamiltonian
+- `test_qec_surface.py`: Surface code parameters, error correction
+- `test_qasm_import.py`: QASM parsing, round-trip, QASMBench, Benchpress
+
+---
+
+## [v0.3.0] - 2026-03-06
+
+### Added — Structural Improvements
+- Custom gates: `custom_gate("name", matrix)`
+- Density matrix simulator: mixed states + Kraus noise
+- Qubit routing: linear/ring/grid topology, SWAP insertion
+- Accelerated backend: JAX/CuPy GPU (auto-detect, NumPy fallback)
+- Parameter sweep: `sweep(circuit, params={...})`
+- Cirq-style display: `print(result)`, `dirac_notation()`, `histogram()`
+- 27-qubit support (100.3s, 2GB)
+
+---
+
+## [v0.2.0] - 2026-03-06
+
+### Added — Performance
+- Tensor contraction simulator: O(2^n) replacing O(4^n)
+- Google Quantum Engine backend (QASM bridge)
+- Load test + installation documentation
+
+### Performance
+| Qubits | v0.1 | v0.2 | Speedup |
+|--------|------|------|---------|
+| 12 | 1.785s | 0.003s | 685x |
+| 20 | impossible | 0.073s | ∞ |
+| 27 | impossible | 100.3s | ∞ |
+
+---
+
+## [v0.1.0] - 2026-03-03
+
+### Added — Foundation
+- Core: 17 gates, circuit decorator, measurement
+- DAG: Directed acyclic graph representation
+- Compiler: 3-pass optimization pipeline
+- Simulator: Statevector (Kronecker)
+- Layer 3: Grover, QAOA, multi-agent
+- QEC: Bit-flip, phase-flip, Steane codes
+- Export: OpenQASM 3.0
+- 98 unit tests

quanta_sdk-0.4.0/LICENSE

@@ -0,0 +1,120 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the copyright owner or its representatives.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event shall any Contributor be
+      liable for any damages arising from the use of this Work.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 Abdullah Enes SARI / ONMARTECH
+   
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

quanta_sdk-0.4.0/PKG-INFO

@@ -0,0 +1,320 @@
+Metadata-Version: 2.4
+Name: quanta-sdk
+Version: 0.4.0
+Summary: Multi-paradigm quantum computing SDK — Grover, QAOA, VQE, Shor, QSVM, surface code, entity resolution
+Project-URL: Homepage, https://github.com/ONMARTECH/quanta-sdk
+Project-URL: Repository, https://github.com/ONMARTECH/quanta-sdk
+Project-URL: Issues, https://github.com/ONMARTECH/quanta-sdk/issues
+Project-URL: Documentation, https://github.com/ONMARTECH/quanta-sdk/tree/main/docs
+Author-email: Abdullah Enes SARI <info@onmartech.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: entity-resolution,grover,qaoa,qasm,qiskit-alternative,qsvm,quantum,quantum-computing,shor,simulator,surface-code,vqe
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.24
+Provides-Extra: dev
+Requires-Dist: hypothesis; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: gpu
+Requires-Dist: cupy-cuda12x; extra == 'gpu'
+Requires-Dist: jax[cuda12]; extra == 'gpu'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">Quanta SDK</h1>
+  <p align="center">
+    <strong>Multi-paradigm quantum computing SDK for Python</strong>
+  </p>
+  <p align="center">
+    <a href="https://github.com/ONMARTECH/quanta-sdk/releases"><img src="https://img.shields.io/badge/version-0.4.0-blue.svg" alt="Version"></a>
+    <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10%2B-brightgreen.svg" alt="Python"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-orange.svg" alt="License"></a>
+    <a href="#quality-benchmark"><img src="https://img.shields.io/badge/tests-150%2B%20passed-success.svg" alt="Tests"></a>
+    <a href="#quality-benchmark"><img src="https://img.shields.io/badge/benchmark-8%2F8-gold.svg" alt="Benchmark"></a>
+    <a href="#qasmbench"><img src="https://img.shields.io/badge/QASMBench-10%2F10-success.svg" alt="QASMBench"></a>
+    <a href="https://github.com/ONMARTECH/quanta-sdk"><img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg" alt="Platform"></a>
+  </p>
+</p>
+
+---
+
+Quanta is a clean, modular quantum computing SDK designed for researchers, engineers and developers. It provides a 3-layer abstraction — from high-level declarative APIs (`search()`, `factor()`) to low-level DAG manipulation and QASM export — so you can work at the level that fits your problem.
+
+**Key highlights:**
+- Shor, VQE, QAOA, QSVM, Grover — production-grade quantum algorithms
+- DAG-based IR with 3-pass compiler and topology-aware qubit routing
+- Statevector simulator up to 27 qubits with optional JAX/CuPy GPU acceleration
+- Surface code QEC, BB84 QKD, and error correction primitives
+- Real-world demo: [quantum entity resolution](#11-entity-resolution) for customer deduplication
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Architecture](#architecture)
+- [Features](#features)
+- [Algorithms](#algorithms)
+- [Examples & Use Cases](#examples--use-cases)
+- [Quality Benchmark](#quality-benchmark)
+- [Installation](#installation)
+- [Documentation](#documentation)
+- [Author](#author)
+- [License](#license)
+
+## Quick Start
+
+```python
+from quanta import circuit, H, CX, measure, run
+
+@circuit(qubits=2)
+def bell(q):
+    H(q[0])
+    CX(q[0], q[1])
+    return measure(q)
+
+result = run(bell, shots=1024)
+print(result)
+```
+
+```
+╔══════════════════════════════════════════════════╗
+║  Quanta Result: bell                            ║
+╠──────────────────────────────────────────────────╣
+║  |00>  ████████████████████  50.5%              ║
+║  |11>  ███████████████████   49.5%              ║
+╠──────────────────────────────────────────────────╣
+║  0.71|00> + 0.71|11>                            ║
+╚══════════════════════════════════════════════════╝
+```
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────┐
+│  Layer 3 — Declarative API                               │
+│  search() · optimize() · vqe() · factor() · qsvm()      │
+│  portfolio_optimize() · resolve() · multi_agent()        │
+├──────────────────────────────────────────────────────────┤
+│  Layer 2 — Circuit API                                   │
+│  @circuit · H · CX · RZ · measure · run · sweep          │
+│  custom_gate() · 17 built-in gates                       │
+├──────────────────────────────────────────────────────────┤
+│  Layer 1 — Physical Layer                                │
+│  DAG IR · 3-pass compiler · qubit routing · QASM I/O     │
+│  statevector · density matrix · JAX/CuPy acceleration    │
+└──────────────────────────────────────────────────────────┘
+```
+
+## Features
+
+### Core
+- **17 built-in gates** — H, X, Y, Z, CX, CCX, SWAP, RX, RY, RZ, S, T, and more
+- **`custom_gate(name, matrix)`** — define your own unitary gates
+- **`@circuit` decorator** — write quantum circuits as Python functions
+- **`sweep(circuit, params)`** — parameter scans for variational algorithms
+
+### Compiler & IR
+- **DAG-based intermediate representation** — directed acyclic graph for circuit analysis
+- **3-pass optimizer** — gate cancellation, gate merging, basis translation
+- **Topology-aware routing** — SWAP insertion for linear, ring, and grid topologies
+- **QASM 2.0/3.0** — import external circuits and export for cross-SDK interop
+
+### Simulators
+- **Statevector** — tensor contraction engine, up to **27 qubits** (100s, 2GB)
+- **Density matrix** — mixed states + Kraus noise channels, up to 13 qubits
+- **Accelerated backend** — auto-detects JAX-GPU / CuPy; falls back to NumPy on CPU
+
+### Error Correction
+- Bit-flip, Phase-flip, **Steane [[7,1,3]]** codes
+- **Surface code [[d²,1,d]]** — logical qubits with configurable distance, threshold ~1%
+
+### Security
+- **BB84 QKD** — quantum key distribution with eavesdropper detection ([Example →](#08-qkd-bb84))
+
+## Algorithms
+
+| Algorithm | Module | Use Case | Example |
+|-----------|--------|----------|---------|
+| **Grover** | `layer3.search` | Unstructured search (√N speedup) | [05 →](#05-grover-search) |
+| **QAOA** | `layer3.optimize` | Combinatorial optimization | [07 →](#07-portfolio-optimization) |
+| **VQE** | `layer3.vqe` | Molecular ground-state energy | [06 →](#06-molecular-energy) |
+| **Shor** | `layer3.shor` | Integer factoring (RSA) | [10 →](#10-quantum-benchmark) |
+| **QSVM** | `layer3.qsvm` | Quantum kernel classification | [10 →](#10-quantum-benchmark) |
+| **Multi-Agent** | `layer3.agent` | Quantum agent-based modeling | [09 →](#09-full-demo) |
+| **Portfolio** | `layer3.finance` | Financial portfolio optimization | [07 →](#07-portfolio-optimization) |
+| **Hamiltonian** | `layer3.hamiltonian` | Molecular simulation (H₂, LiH, HeH⁺) | [06 →](#06-molecular-energy) |
+| **Entity Resolution** | `layer3.entity_resolution` | Customer deduplication (QAOA) | [11 →](#11-entity-resolution) |
+
+## Examples & Use Cases
+
+Run any example with `python -m quanta.examples.<name>`:
+
+### 01 Bell State
+EPR pair — the simplest entanglement demonstration.
+```bash
+python -m quanta.examples.01_bell_state
+```
+
+### 02 GHZ State
+Multi-qubit entanglement: all-or-nothing correlations.
+```bash
+python -m quanta.examples.02_ghz_state
+```
+
+### 03 Quantum Teleportation
+Transfer an unknown quantum state using entanglement + classical bits.
+```bash
+python -m quanta.examples.03_teleportation
+```
+
+### 04 Deutsch-Jozsa
+Determine if a function is constant or balanced in one query.
+```bash
+python -m quanta.examples.04_deutsch_jozsa
+```
+
+### 05 Grover Search
+Quadratic speedup for unstructured search — finds target with 99.9% probability.
+```bash
+python -m quanta.examples.05_grover
+```
+
+### 06 Molecular Energy
+H₂ and HeH⁺ ground state via VQE + Hamiltonian time evolution.
+```bash
+python -m quanta.examples.06_molecule_energy
+```
+
+### 07 Portfolio Optimization
+Quantum-optimized stock portfolios — tech vs crypto, conservative vs aggressive.
+```bash
+python -m quanta.examples.07_portfolio_optimization
+```
+
+### 08 QKD BB84
+Quantum key distribution — detect eavesdroppers via ~25% error rate.
+```bash
+python -m quanta.examples.08_qkd_bb84
+```
+
+### 09 Full Demo
+All SDK features in one script — circuits, custom gates, VQE, Grover, noise, routing, QASM.
+```bash
+python -m quanta.examples.09_full_demo
+```
+
+### 10 Quantum Benchmark
+8-test quality litmus test — Bell fidelity, CHSH, teleportation, Grover, VQE, Shor, QSVM, surface code.
+```bash
+python -m quanta.examples.10_quantum_benchmark
+```
+
+### 11 Entity Resolution
+**Real-world use case:** OTA customer deduplication with QAOA vs classical greedy.  
+25 records, 8 columns, Turkish name handling, 3-layer blocking pipeline.  
+**Result:** QAOA 86% accuracy vs Greedy 64%.
+```bash
+python -m quanta.examples.11_entity_resolution
+```
+
+## Quality Benchmark
+
+### Turnusol Test — 8/8 🏆
+
+| # | Test | Result | Metric |
+|---|------|--------|--------|
+| 1 | Bell State Fidelity | ✅ | F = 1.0000 |
+| 2 | CHSH Inequality | ✅ | S = 2.8284 (Tsirelson bound) |
+| 3 | Quantum Teleportation | ✅ | Unitarity preserved |
+| 4 | Grover Amplification | ✅ | 99.9% target probability |
+| 5 | VQE Convergence (H₂) | ✅ | 0.000054 Ha error |
+| 6 | Shor Factoring | ✅ | 15 = 3 × 5 |
+| 7 | QSVM Classification | ✅ | 100% accuracy |
+| 8 | Surface Code QEC | ✅ | 0% logical error rate |
+
+### QASMBench — 10/10
+
+All standard QASMBench circuits import, compile, and simulate correctly:  
+`bell` · `ghz` · `qft` · `teleportation` · `deutsch-jozsa` · `grover` · `adder` · `vqe_ansatz` · `swap_test` · `random`
+
+Large circuit support: GHZ-20 (710ms), QFT-20 (3.5s), Random-24 (12s).
+
+### Benchpress Compatible
+
+Includes `QuantaBenchpressBackend` adapter for cross-SDK benchmarking alongside Qiskit, Cirq, and Braket using the [Benchpress](https://arxiv.org/abs/2406.14155) framework.
+
+## Installation
+
+```bash
+# Clone and install
+git clone https://github.com/ONMARTECH/quanta-sdk.git
+cd quanta-sdk
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run benchmark
+python -m quanta.examples.10_quantum_benchmark
+```
+
+**Optional GPU acceleration:**
+```bash
+pip install jax jaxlib   # JAX GPU backend
+pip install cupy          # NVIDIA CUDA backend
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Architecture (EN)](docs/ARCHITECTURE_EN.md) | System design, DAG IR, compiler pipeline |
+| [Architecture (TR)](docs/ARCHITECTURE_TR.md) | Türkçe mimari dokümanı |
+| [Features (EN)](docs/FEATURES_EN.md) | Complete feature list |
+| [Comparison (EN)](docs/COMPARISON_EN.md) | vs Qiskit, Cirq, Braket |
+| [CHANGELOG](CHANGELOG.md) | Version history |
+
+## Project Stats
+
+```
+Files:       86          Languages:   Python
+Lines:       11,770      Tests:       150+
+Algorithms:  9           Examples:    11
+Simulators:  3           QEC Codes:   4
+QASM:        2.0 + 3.0   Max Qubits:  27
+```
+
+## Author
+
+**Abdullah Enes SARI** — [ONMARTECH](https://onmartech.com)
+
+**info@onmartech.com**
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome!  
+Feel free to check [issues page](https://github.com/ONMARTECH/quanta-sdk/issues).
+
+## License
+
+[Apache License 2.0](LICENSE)
+
+---
+
+<p align="center">
+  <sub>Built for the quantum computing community</sub>
+</p>