Qlite (`kla•yt) is a lightweight, modular quantum compiler and simulator designed for both beginners and quantum enthusiasts. Build quantum algorithms from the command line, simulate them locally, or seamlessly export to IBM Quantum—all with a streamlined, mobile-friendly interface. It bridges the gap between high-level quantum programming and local simulation, featuring a custom AST-based Qlite interpreter and an integrated circuit visualization tool.
- CLI to Cloud: Program quantum algorithms directly from your terminal
- Local Simulation: Test and debug circuits without leaving your machine
- IBM Quantum Integration: Export your work to IBM's quantum processors
- Mobile-Friendly: Access the full development pipeline from any device. Designed with a clean, modular architecture accessible for any dev environment.
- Modular Architecture: Build and compose quantum components with ease
- Custom DSL: A streamlined syntax for defining qubits and gates.
- Local High-Fidelity Simulation: Full state-vector simulation supporting superposition and entanglement.
- ASCII Circuit Drawing: Visualize your quantum circuits directly in the terminal.
- Advanced Gate Library: Support for
H,X,Z,RX(θ),CNOT, andCZ.
Clone the repository and install the dependencies:
git clone [https://github.com/MAX25M/qlite.git](https://github.com/MAX25M/qlite.git)
cd qlite
pip install -r requirements.txtUsage
- The Qlite Language (.ql) Write your quantum algorithms in a simple, declarative style:
// Example: Bell State
qubit q[2];
H q[0];
CNOT(q[0], q[1]);- Running the Simulator You can use the simulator directly in Python to execute gates or process an AST:
from core.simulator import Simulator
# Initialize 2 qubits
sim = Simulator(num_qubits=2)
# Apply gates
sim.apply_gate('H', [0])
sim.apply_gate('CNOT', [0, 1])
# Visualize the circuit
sim.draw()
# Get state results
print(sim.get_probabilities())- Circuit Visualization Q-Lite includes a built-in ASCII drawer to debug your circuit logic visually:
q0: ──[H]────●──
q1: ────────[X]─| Gate | Type | Description |
|---|---|---|
| H | Single | Creates superposition ($ |
| X | Single | Pauli-X (Quantum NOT gate) |
| Z | Single | Pauli-Z (Phase flip) |
| RX(θ) | Single | Rotation around the X-axis |
| CNOT | Multi | Controlled-NOT (Entangles two qubits) |
| CZ | Multi | Controlled-Z (Phase entanglement) |
We use unittest to ensure mathematical accuracy of the state-vector transitions.
export PYTHONPATH=$PYTHONPATH:$(pwd)
python -m unittest discover tests- Initial state |00\rangle verification.
- Bell State probability distribution (50/50 split).
- CZ Gate phase-interference logic.
State-vector Simulation
OpenQASM 3.0 Compatibility
If you find Qlite useful, please consider supporting its development!
If Qlite helped you learn quantum computing or speed up your workflow, consider buying me a coffee! Your support helps keep the project alive and free.
This project is licensed under the
If you use this software in your work, please cite it as follows:
@software{Qlite,
author = {Mark Joseph N. Octavo},
title = {Qlite Language and Compiler},
url = {https://github.com/MAX25M/qlite},
version = {0.0.6},
year = {2026}
}
©2026 Qlite Language Distribution Systems. All rights reserved