Metadata-Version: 2.4
Name: qoro-divi
Version: 0.7.0
Summary: A Python library to automate generating, parallelizing, and executing quantum programs.
License-File: LICENSE
License-File: LICENSES/.license-header
License-File: LICENSES/Apache-2.0.txt
Author: Ahmed Darwish
Author-email: ahmed@qoroquantum.de
Requires-Python: >=3.11,<3.13
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: basis-set-exchange (>=0.11,<0.12)
Requires-Dist: cirq-core (>=1.6,<2.0)
Requires-Dist: dill (>=0.4.0,<0.5.0)
Requires-Dist: dwave-hybrid (>=0.6.14,<0.7.0)
Requires-Dist: matplotlib (>=3.10.3,<4.0.0)
Requires-Dist: mitiq (>=0.48,<0.49)
Requires-Dist: networkx (>=3.5,<4.0)
Requires-Dist: numpy
Requires-Dist: pennylane (>=0.43,<0.44)
Requires-Dist: pennylane-qiskit (>=0.43,<0.44)
Requires-Dist: ply (>=3.11,<4.0)
Requires-Dist: pydantic (>=2.5.0,<2.10)
Requires-Dist: pymetis (>=2025.1.1,<2026.0.0) ; sys_platform != "win32"
Requires-Dist: pymoo (>=0.6,<0.7)
Requires-Dist: python-dotenv (>=1.1.1,<2.0.0)
Requires-Dist: qiskit (>=2.1,<2.3)
Requires-Dist: qiskit-aer
Requires-Dist: qiskit-ibm-runtime (>=0.41,<0.42)
Requires-Dist: requests (>=2.32.4,<3.0.0)
Requires-Dist: rich (>=14.0.0,<15.0.0)
Requires-Dist: scikit-learn (>=1.7.0,<2.0.0)
Requires-Dist: scipy (>=1.16,<2.0)
Requires-Dist: sympy (>=1.14.0,<2.0.0)
Description-Content-Type: text/markdown

# Divi

**Divi** is a Python library for generating quantum programs at scale. It allows users to parallelize quantum workloads, manage hardware or simulator execution, and interact with cloud-based compute clusters—all through a simple and flexible API.

Divi is designed to allow researchers, students, and enterprises to deploy quantum workloads efficiently across hybrid and distributed environments.

---

> [!IMPORTANT]
> Divi is under active development and in early stages. Users should expect frequent changes that are likely to be incompatible with previously published versions.

## 🚀 Features

- 🧠 **Smart Job Parallelization**: Automatically parallelizes your quantum programs based on task structure.
- 🌐 **Cloud Execution**: Send jobs to local or remote clusters with minimal configuration.
- 🔌 **Extensible API**: Easily integrate with your existing quantum stack.
- 📦 **Lightweight & Modular**: Install and use only what you need.

---

## 📦 Installation

Divi can be easily installed from Pypi

```bash
pip install qoro-divi
```

## 📚 Documentation

- Full documentation is available at: <https://docs.qoroquantum.net/divi>
- Tutorials can be found in the `tutorials` folder.

## 🧪 Testing

To run the test suite:

```bash
# Run all tests
pytest

# Run only API tests (requires API token)
pytest --run-api-tests
```

**Note:** Some tests require a Qoro API token to test the cloud REST API. Set the `QORO_API_KEY` environment variable or use the `--api-token` option. For local development, you can create a `.env`.

