Skip to main content

Aleshnatt Quantum SDK (aleshaq-sdk)

License: MIT Python Version Qiskit Compatibility

Aleshnatt Quantum SDK (aleshaq) is a modular, production-grade Python toolkit for quantum computing, quantum error correction, quantum networking, and quantum cryptographic protocols. Built natively on Qiskit.


Architecture & Packages

aleshaq unites the full quantum information stack into four cohesive modules:

┌────────────────────────────────────────────────────────────────────────┐
│                        aleshaq-sdk (Top-Level)                         │
├────────────────────────────────────────────────────────────────────────┤
│ 1. aleshaq.primitives  │ Bell/GHZ/W States, QFT, QPE, Oracles, Backend │
├────────────────────────┼───────────────────────────────────────────────┤
│ 2. aleshaq.qec         │ Stabilizers (Shor, Steane), Decoders, Noise   │
├────────────────────────┼───────────────────────────────────────────────┤
│ 3. aleshaq.networking  │ Nodes, Quantum Channels, Swapping, Routing    │
├────────────────────────┼───────────────────────────────────────────────┤
│ 4. aleshaq.protocols   │ QKD (BB84, B92, E91, Decoy), Teleportation    │
└────────────────────────────────────────────────────────────────────────┘

Installation

# Base SDK installation:
pip install aleshaq-sdk

# With local simulation (Qiskit Aer):
pip install "aleshaq-sdk[sim]"

# With hardware providers (IBM Quantum Runtime & qBraid):
pip install "aleshaq-sdk[ibm]"
pip install "aleshaq-sdk[qbraid]"

# Complete installation with all dependencies:
pip install "aleshaq-sdk[all]"

Quick Start

1. Quantum Primitives (aleshaq.primitives)

from aleshaq.primitives import bell_state, ghz_state, qft, phase_estimation

# Prepare a Bell state (|Φ⁺⟩) circuit
qc_bell = bell_state(0)
print(qc_bell)

# Generate a 3-qubit Quantum Fourier Transform circuit
qc_qft = qft(n_qubits=3, do_swaps=True)
print(qc_qft)

2. Quantum Error Correction (aleshaq.qec)

from aleshaq.qec import SteaneCode, LookupTableDecoder, extract_syndrome

# Instantiate the 7-qubit Steane [[7,1,3]] code
code = SteaneCode()
encoder_circuit = code.encode()

# Extract stabilizer syndromes
syndrome_qc = code.syndrome_circuit()

3. Quantum Networking (aleshaq.networking)

from aleshaq.networking import QuantumNetwork, Node
from aleshaq.networking.protocols import EntanglementDistribution

# Build a 3-node quantum network
net = QuantumNetwork("Aleshnatt-Network")
alice = Node("Alice", qubit_capacity=4)
repeater = Node("Repeater", qubit_capacity=4)
bob = Node("Bob", qubit_capacity=4)

net.add_node(alice)
net.add_node(repeater)
net.add_node(bob)
net.connect(alice, repeater, length_km=10.0)
net.connect(repeater, bob, length_km=10.0)

# Distribute entanglement over multi-hop routing
dist = EntanglementDistribution(net)
res = dist.distribute("Alice", "Bob")
print(f"End-to-end fidelity: {res.fidelity:.4f}")

4. Quantum Protocols & Cryptography (aleshaq.protocols)

from aleshaq.protocols import BB84, DecoyStateBB84, Teleportation

# Run BB84 QKD Simulation
bb84 = BB84(n_bits=500, eavesdropper_present=False, seed=42)
result = bb84.run()
print(f"Sifted key length: {len(result.sifted_key_alice)}, QBER: {result.qber}")

# Run Decoy-State BB84 with Photon-Number Splitting (PNS) detection
decoy = DecoyStateBB84(n_rounds=1000, mu=0.5, nu=0.1, simulate_pns_attack=False)
decoy_res = decoy.run()
print(f"PNS Attack Detected: {decoy_res.pns_attack_detected}")

Development & Testing

# Clone the repository
git clone https://github.com/naufaziy/aleshaq.git
cd aleshaq

# Install in editable mode with development tools
pip install -e ".[dev]"

# Run tests
pytest

License

This project is licensed under the MIT License.

Metadata

Release files for aleshaq-sdk 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aleshaq-sdk 0.1.2
File Size Uploaded Provenance Actions
aleshaq_sdk-0.1.2.tar.gz 56.5 kB With provenance Details for aleshaq_sdk-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aleshaq-sdk 0.1.2
File Interpreter ABI Platform Actions
aleshaq_sdk-0.1.2-py3-none-any.whl Python 3 none any Details for aleshaq_sdk-0.1.2-py3-none-any.whl

Total release size: 130.4 kB

Release files / aleshaq_sdk-0.1.2.tar.gz

Download URL aleshaq_sdk-0.1.2.tar.gz
Size 56.5 kB
Tags Source
SHA-256 checksum
How to use checksums
ffea8eec5ee71c91d0284bf5f15a07c53280bdeb4e76af62165869a3dada1715
BLAKE2b-256 checksum
How to use checksums
c1783e40650dd3c1f2e34f49efb707b3dc3a3340d3c8256658f5929b316c9204
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / aleshaq_sdk-0.1.2-py3-none-any.whl

Download URL aleshaq_sdk-0.1.2-py3-none-any.whl
Size 73.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5fb428f9a661e543550dfe22b6f6bc4d24cc0ce1993949a38f60a5a61b3f1920
BLAKE2b-256 checksum
How to use checksums
5d24cd17960b721169190c2559d7111f0d6766d1edbb8c2cde4f852d0bce2eba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for aleshaq-sdk 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aleshaq_sdk-0.1.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page