cirquit 1.1.0

---

🚀 Quick Start

pip install cirquit

from cirquit import QuantumCircuit

# Create a Bell state (quantum entanglement)
qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

# Run the circuit
result = qc.run(shots=1000)
print(result)

That's it! You just created quantum entanglement.

---

🎯 What is Cirquit?

Cirquit is a Python library for building quantum circuits with a developer-first approach. No quantum physics PhD required.

• 🎯 Simple API - Intuitive, Pythonic interface
• ⚡ Fast - Optimized quantum circuit simulation
• 📚 Well Documented - Clear examples and tutorials
• 🔧 Extensible - Easy to add custom gates
• 🌐 Open Source - MIT licensed

Perfect for learning, prototyping, and algorithm development.

---

✨ Features

Comprehensive Gate Library

Single-qubit gates:

• Pauli gates: x(), y(), z()
• Hadamard: h()
• Rotations: rx(), ry(), rz()

Two-qubit gates:

• cx() - CNOT (controlled-NOT)
• cz() - Controlled-Z
• More coming soon!

Method Chaining

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

Circuit Information

print(qc)
# Output: QuantumCircuit(3 qubits, 6 gates)

---

📖 Examples

Bell State

from cirquit import QuantumCircuit

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

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

GHZ State (3-qubit Entanglement)

from cirquit import QuantumCircuit

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

from cirquit import QuantumCircuit

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

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

📁 More examples: examples/

---

🛠️ Installation

Requirements

• Python 3.11 or higher
• NumPy

Install from PyPI

pip install cirquit

Install from Source

git clone https://github.com/tony-siqurity-ai/cirquit-web.git
cd cirquit-web
pip install -e .

---

📚 Documentation

Full documentation is available at docs.cirquit.dev

• Getting Started
• API Reference
• Examples

---

🗺️ Roadmap

✅ v1.0 (Current)

• Core quantum gates (H, X, Y, Z, CX)
• Basic statevector simulation
• Method chaining API
• PyPI package

🚧 v1.1 (Next)

• Circuit visualization
• More quantum gates (CZ, SWAP, Toffoli)
• Result analysis tools
• Performance optimizations

🔮 Future

• Advanced quantum algorithms
• Noise simulation
• GPU-accelerated simulation
• Cloud API

See our full roadmap →

---

🤝 Contributing

Contributions are welcome! Here's how you can help:

• 🐛 Report bugs by opening an issue
• ✨ Suggest features in discussions
• 📝 Improve documentation
• 🔧 Submit pull requests

See CONTRIBUTING.md for guidelines.

Development Setup

# Clone the repository
git clone https://github.com/tony-siqurity-ai/cirquit-web.git
cd cirquit-web

# Install in development mode
pip install -e .

# Run tests (if you have them)
python -m pytest tests/

---

📄 License

Cirquit is released under the MIT License.

---

🙏 Acknowledgments

Built for the quantum computing community.

Special thanks to early adopters and contributors!

---

🗺️ Roadmap

See our public roadmap for upcoming features and Cloud API development.

Want to influence what we build? Open a discussion!

---