Metadata-Version: 2.4
Name: zena-sdk
Version: 0.1.0
Summary: A high-level Python SDK for the Zena Quantum Simulator, inspired by Qiskit.
Author-email: Zena Team <info@zena.quantum>
License: Apache-2.0
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: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.8
Requires-Dist: numpy>=1.20
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Description-Content-Type: text/markdown

# 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: Requires valid `qsys` and `simulator_statevector` backend installations)*

## 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. visualizae
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 (`zena`) sits on top of the Core Engine (`qsys`).

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