Metadata-Version: 2.4
Name: ojanvu
Version: 1.0.0
Summary: Official Python SDK for Ojanvu Continuous-Variable Quantum Computing Processors
Author: Ojanvu Quantum Labs
Author-email: Ojanvu Quantum Labs <contact@ojanvu.com>
License: Proprietary
Project-URL: Homepage, https://ojanvu.com
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pyserial>=3.5
Dynamic: author
Dynamic: requires-python

# Ojanvu Python SDK (`ojanvu`) v1.0.0

The official Python client library for executing quantum programs on **Ojanvu Continuous-Variable Quantum Computing (CVQC)** hardware.

## Installation

```bash
pip install ojanvu
```
Or install locally in development mode:
```bash
pip install -e python/
```

## Quick Start

```python
from ojanvu import Planck2

# Auto-detects port, securely authenticates, and initializes the quantum photonic core
qpu = Planck2()

# Execute OpenQASM circuit
qasm_circuit = """
qreg q[2];
creg c[2];
h q[0];
cx q[0], q[1];
measure q -> c;
"""

result = qpu.execute(qasm_circuit, shots=1000)
print("Measurement Counts:", result.get_counts())
print("Probabilities:", result.get_probabilities())

# Clean session release
qpu.close()
```

## Context Manager Support

```python
from ojanvu import Planck2

with Planck2() as qpu:
    diag = qpu.get_optical_diagnostics()
    print("Optical Interlock Status:", diag["optical_status"])
```

## Core Capabilities
- **OpenQASM Execution:** Discrete-variable logical qubits via 3:1 Sovereign Chromatic QEC.
- **Continuous-Variable Execution (CV-QASM):** Native photonic qumodes, phase rotations, and displacement operations.
- **Hardware Solvers:** Built-in hardware VQE, QUBO optimization, and Thermodynamic Integration (TI).
- **Session Protection:** Automatic keepalive heartbeat prevents session timeout during long benchmarks.

