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.0

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.0
File Size Uploaded Provenance Actions
aleshaq_sdk-0.1.0.tar.gz 55.3 kB With provenance Details for aleshaq_sdk-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 128.4 kB

Release files / aleshaq_sdk-0.1.0.tar.gz

Download URL aleshaq_sdk-0.1.0.tar.gz
Size 55.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f7ad5d84db4026a1bcd34b92f8b84b2fc2be38f899548055bd858fd955bb3b6a
BLAKE2b-256 checksum
How to use checksums
56ecb8f69e952c9e638e5d0c688c2d17430fe44ec6f3f71b686dc5d92c4436cd
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 8, 2026.

Transparency log

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

Download URL aleshaq_sdk-0.1.0-py3-none-any.whl
Size 73.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
86b922525a72982a1010663fcbf62ff3849c4a850e56939acf1a7101b70043ed
BLAKE2b-256 checksum
How to use checksums
c1136c4fc80b4da12833d088f9d7b603cdbdde077fe9d96d25556d5aa4bbd9e1
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 8, 2026.

Transparency log

Security for aleshaq-sdk 0.1.0

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.0.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 8, 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.0 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