Skip to content

QPyth

Quantum Computing Python 3.10+ License Apache 2.0 Version 0.3.4 PyPI version CI/CD Pipeline Codecov

QPyth is a professionally engineered, physically rigorous quantum computing library built on Qiskit. Moving beyond ideal statevector simulations, QPyth provides canonical implementations of advanced quantum algorithms, including Variational Quantum Eigensolvers (VQE) for multi-electron molecules, robust Quantum Error Correction (QEC) protocols, and seamless IBM Quantum hardware execution. Featuring a proprietary offline noise simulation engine powered by historical IBM device calibration data, QPyth ensures every component follows standard physical implementations—delivering real simulation, authentic hardware routing, and graceful dependency handling within a full-stack environment.

🌟 Key Features

  • Physically grounded quantum workflows — canonical implementations built on Qiskit, with textbook-aligned circuits and real simulation behavior.
  • Molecular VQE — H₂ plus extended molecule support through the VQE stack, with physical and lightweight execution paths.
  • IBM Quantum execution — run circuits on real IBM backends with configurable shots, backend routing, and runtime options.
  • Hardware-calibrated noisy simulation — offline noise models derived from IBM calibration profiles for more realistic testing.
  • Core quantum protocols — Bloch state analysis, Bell-state exploration, teleportation, and measurement-driven circuit demos.
  • Quantum error correction — built-in Shor 9-qubit and Steane 7-qubit code implementations.
  • Sacred-geometry modules — QRNG with phi-scaling and the 21-qubit TMT Sierpinski circuit.
  • CLI + Web UI — interactive command-line interface plus optional FastAPI + React web UI for exploration.

🚀 Quick Start

Installation

# Core package (Qiskit, Qiskit-Aer, NumPy)
pip install QPyth

# With physical VQE support (requires qiskit-algorithms, qiskit-nature, pyscf)
pip install QPyth[physical]

# With IBM Quantum hardware support (requires qiskit-ibm-runtime)
pip install QPyth[hardware]

# With web UI support (requires FastAPI, uvicorn)
pip install QPyth[web]

# Development mode (all extras)
pip install -e .[dev,physical,web,hardware]

CLI Mode

# Run the interactive quantum playground
qpy

# Or directly via Python module
python -m quantumpytho

Web UI Mode

# Start the FastAPI backend
python server.py           # http://localhost:8000

# Start the React frontend (in a separate terminal)
cd web
npm install
npm run dev                # http://localhost:3000

📚 Documentation

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for details.

📄 License

QPyth is licensed under the Apache License 2.0. See LICENSE for details.