Metadata-Version: 2.4
Name: zena-sdk
Version: 0.1.8
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
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: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Dist: numpy>=1.24.0
Requires-Dist: fastapi>=0.109.0 ; extra == 'backend'
Requires-Dist: uvicorn[standard]>=0.27.0 ; extra == 'backend'
Requires-Dist: pydantic>=2.6.0 ; extra == 'backend'
Requires-Dist: requests>=2.31.0 ; extra == 'backend'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: hypothesis ; extra == 'dev'
Requires-Dist: black ; extra == 'dev'
Requires-Dist: ruff ; extra == 'dev'
Provides-Extra: backend
Provides-Extra: dev
License-File: LICENSE
Summary: A high-level Python SDK for the Zena Quantum Simulator, including core Rust engine.
Keywords: quantum,sdk,simulator,statevector,quantum-computing,rust,qasm
Home-Page: https://github.com/epazztech/quantum.hw.sdk
Author: Zena Team
License: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/epazztech/quantum.hw.sdk/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/epazztech/quantum.hw.sdk/tree/main/docs
Project-URL: Homepage, https://github.com/epazztech/quantum.hw.sdk
Project-URL: Repository, https://github.com/epazztech/quantum.hw.sdk

# Zena SDK

**Zena SDK** is a high-level Python library for creating and simulating quantum circuits, designed with a familiar API for users of Qiskit. It serves as the user-facing layer for the powerful Zena Quantum Simulator engine.

## Installation

```bash
pip install zena-sdk
```
*(Note: Binary wheels include all necessary simulation kernels for Windows and Linux)*

## Basic Usage

Zena SDK allows you to build circuits using `QuantumRegister`, `ClassicalRegister`, and `QuantumCircuit` in a way that feels completely natural.

```python
from zena import QuantumCircuit, execute, Aer

# 1. Create a Quantum Circuit
qc = QuantumCircuit(2, 2)
qc.h(0)
qc.cx(0, 1)
qc.measure([0, 1], [0, 1])

# 2. Visualize
print(qc.draw())

# 3. Choose a Backend
backend = Aer.get_backend('statevector_simulator')

# 4. Execute
job = execute(qc, backend, shots=1024)
result = job.result()

# 5. Get Results
print("Counts:", result.get_counts())
```

## Features

- **Familiar API**: Drop-in conceptual replacement for basic Qiskit circuits.
- **High Performance**: Powered by a Rust-based statevector simulator.
- **Visualizations**: Built-in methods for circuit drawing and result plotting.
- **Extensible**: Modular architecture allowing for future backend plugins.

## Architecture

Zena SDK sits on top of the Core Engine.

- **Base Layer**: `qsys` (Intermediate Representation & Composer)
- **Simulation Layer**: `simulator_statevector` (Rust-based capabilities)
- **User Layer**: `zena` (High-level Circuit & Provider API)

---
For detailed documentation, visit the [docs/](docs/) directory.

