Metadata-Version: 2.4
Name: anuastra
Version: 1.6.0
Summary: Official Python SDK for the Aṇu Astra Virtual Quantum Processor and PQC API
Home-page: https://astra.cryptopix.in
Author: Aṇu Astra
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.1
Requires-Dist: fips203>=0.4.3
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🌌 Aṇu Astra: Official Python SDK (v1.6.0)

[![PyPI version](https://img.shields.io/pypi/v/anuastra.svg?style=flat-square)](https://pypi.org/project/anuastra)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)

The official Python SDK for the **Aṇu Astra 1024-Qubit Virtual Quantum Processor (VQP)** and **Post-Quantum Cryptography (PQC)** API.

Build research-grade path-integral quantum circuits, execute high-fidelity Bell State benchmarks, and secure your data with NIST-standardized quantum-safe algorithms.

## 🚀 Installation

Install the package via pip:

```bash
pip install anuastra
```

## ⚛️ Quick Start: "Quantum Hello World" (Bell State)

The `QuantumCircuit` builder provides a fluent interface for high-performance quantum simulation.

```python
from anuastra import AnuAstra, QuantumCircuit

# Initialize the v1.6.0 Research Client
client = AnuAstra(api_key="sk_live_YourAstraKeyHere")

# Scaffold a 2-qubit register
qc = QuantumCircuit(2)
qc.h(0).cx(0, 1) # Create entanglement (Bell State)

# Execute on the VQP Engine
result = client.execute_quantum(qc, shots=1024)

print(f"Executed on: {result['engine']}")
print(f"Results: {result['results']['counts']}")

# Retrieve the Scientific Receipt (OpenQASM 2.0 Export)
print(f"OpenQASM: {result['telemetry']['qasm_receipt']}")
```

## 🏗️ Industrial Portability: OpenQASM Bridge

Aṇu Astra v1.6.0 enables a 360-degree circuit validation loop. Export natively built Python circuits to industrial standard OpenQASM 2.0 strings for archival and documentation.

```python
qc = QuantumCircuit(3)
qc.h(0).cx(0, 1).cx(1, 2) # 3-Qubit GHZ State

# Export to OpenQASM 2.0
qasm_string = qc.to_qasm()
print(qasm_string)
```

## 🛡️ Post-Quantum Cryptography (PQC)

Secure your applications using FIPS-standardized ML-KEM and ML-DSA primitives.

```python
# Generate Kyber-768/ML-KEM Keypair
keypair = client.pqc.generate_keypair("kyber768")
public_key = keypair["public_key"]

# Encapsulate a shared secret
encap = client.pqc.encapsulate(public_key)
ciphertext = encap["ciphertext"]
shared_secret = encap["shared_secret"]
```

## 📊 VQP v1.6.0 Capability Matrix

| Feature | Support Level | Advantage |
| :--- | :--- | :--- |
| **Qubits** | Up to 1024 | O(N) Forward-Path Sampling |
| **Standards** | OpenQASM 2.0 | Full Ingestion & Export |
| **Math** | 35+ Gates | H, CX, TOFFOLI, RZ, CSWAP, etc. |
| **Trust** | Ed25519 | JSON Scientific Receipts |

---
**© 2026 CryptoPIX Aṇu Astra. Decentralized Intelligence Infrastructure.**
