quantIQ Documentation

📦 Installation

Install quantIQ using pip. Requires Python 3.11 or higher.

pip install quantiq-dev

Requirements

Python 3.11+
NumPy (installed automatically)

🚀 Quick Start

Create your first quantum circuit in under a minute:

from quantiq import QuantumCircuit

# Create a Bell state (quantum entanglement)
qc = QuantumCircuit(2)
qc.h(0)           # Apply Hadamard gate to qubit 0
qc.cx(0, 1)       # Apply CNOT gate
qc.measure_all()  # Measure all qubits

# Run the circuit
result = qc.run(shots=1000)
print(result)
# Output: QuantumCircuit(2 qubits, 3 gates)

That's it! You just created quantum entanglement. The Bell state creates perfect correlation between two qubits.

💡 Core Concepts

Quantum Circuits

A sequence of quantum gates applied to qubits. Build circuits using an intuitive Python API.

Quantum Gates

Operations that manipulate qubits. quantIQ supports all common single and two-qubit gates.

Measurement

Observing quantum states collapses them to classical bits. Run multiple shots to see probability distributions.

📚 API Reference

QuantumCircuit

The main class for building quantum circuits.

from quantiq import QuantumCircuit

qc = QuantumCircuit(num_qubits)

Single-Qubit Gates

Method	Description	Example
`h(qubit)`	Hadamard gate - creates superposition	`qc.h(0)`
`x(qubit)`	Pauli-X gate - quantum NOT	`qc.x(1)`
`y(qubit)`	Pauli-Y gate	`qc.y(0)`
`z(qubit)`	Pauli-Z gate - phase flip	`qc.z(2)`

Two-Qubit Gates

Method	Description	Example
`cx(control, target)`	CNOT gate - controlled-NOT	`qc.cx(0, 1)`

Measurement

Method	Description	Example
`measure_all()`	Measure all qubits	`qc.measure_all()`

Execution

Method	Description	Example
`run(shots=1000)`	Execute circuit with specified number of shots	`result = qc.run(shots=2048)`

📖 Examples

Bell State (Quantum Entanglement)

Create perfect correlation between two qubits:

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

result = qc.run(shots=1000)
# Result: ~50% |00⟩ and ~50% |11⟩

GHZ State (3-Qubit Entanglement)

Extend entanglement to three qubits:

qc = QuantumCircuit(3)
qc.h(0)
qc.cx(0, 1)
qc.cx(1, 2)
qc.measure_all()

result = qc.run(shots=1000)
# Result: ~50% |000⟩ and ~50% |111⟩

Superposition

Create equal probability of measuring 0 or 1:

qc = QuantumCircuit(1)
qc.h(0)  # Hadamard creates superposition
qc.measure_all()

result = qc.run(shots=1000)
# Result: ~50% |0⟩ and ~50% |1⟩

Method Chaining

Build circuits fluently with method chaining:

qc = QuantumCircuit(3)
qc.h(0).h(1).h(2).cx(0, 1).cx(1, 2).measure_all()

result = qc.run(shots=1000)

🎯 Next Steps

Ready to dive deeper? Check out these resources:

Blog View More Examples GitHub Repository PyPI Package