MIMIQ Circuits is a comprehensive Python library for building, simulating, and executing quantum circuits on QPerfect's MIMIQ Virtual Quantum Computer. Design quantum algorithms, test them locally, and scale them on high-performance cloud simulators.
Part of the MIMIQ ecosystem by QPerfect.
- 🔧 Build quantum circuits with a Pythonic, intuitive API
- ☁️ Execute on MIMIQ cloud with automatic job management
- 🔄 Import/Export OpenQASM and Stim files for interoperability
- 🎯 Multiple simulation algorithms (state vector, MPS, and more)
- 📈 Expectation values and measurements for quantum observables
- 🌐 Seamless cloud integration with authentication and connection management
- 🧪 Noise modeling with realistic quantum error channels
pip install mimiqcircuitspip install mimiqcircuits[visualization]pip install "mimiqcircuits @ git+https://github.com/qperfect-io/mimiqcircuits-python.git"- Python 3.8 or higher
- Supported on Linux, macOS, and Windows
from mimiqcircuits import *
# Create a Bell state circuit
circuit = Circuit()
circuit.push(GateH(), 0)
circuit.push(GateCX(), 0, 1)
circuit.push(Measure(), 0, 0)
circuit.push(Measure(), 1, 1)
# Print the circuit
circuit.draw()from mimiqcircuits import *
# Establish connection (opens browser for authentication)
conn = MimiqConnection()
conn.connect()
# Alternative: Connect with credentials directly
# conn.connectUser("your.email@example.com", "yourpassword")from mimiqcircuits import *
# Create a multi-qubit entangled state
circuit = Circuit()
circuit.push(GateH(), 0)
for i in range(1, 10):
circuit.push(GateCX(), 0, i)
circuit.push(Measure(), range(10), range(10))
# Connect to MIMIQ
conn = MimiqConnection()
conn.connect()
# Submit to MIMIQ remote services
job = conn.submit(circuit, algorithm="auto", nsamples=1000)
# Wait for completion and retrieve results
results = conn.get_results(job)
# Visualize results
from mimiqcircuits.visualization import plothistogram
plothistogram(results)from mimiqcircuits import *
# Connect to MIMIQ
conn = MimiqConnection()
conn.connect()
# Submit a QASM file
job = conn.submit("path/to/circuit.qasm", algorithm="statevector")
results = conn.get_results(job)from mimiqcircuits import *
circuit = Circuit()
# QFT on 5 qubits
circuit.push(QFT(5), *range(5))
circuit.push(Barrier(5), *range(5))
circuit.push(inverse(QFT(5)), *range(5))
circuit.draw()from mimiqcircuits import *
import numpy as np
circuit = Circuit()
theta = np.pi / 4
# Rotation gates with parameters
circuit.push(GateRX(theta), 0)
circuit.push(GateRY(theta), 1)
circuit.push(GateRZ(theta), 2)
# Custom controlled rotation
circuit.push(GateCRX(theta), 0, 1)
circuit.draw()from mimiqcircuits import *
circuit = Circuit()
circuit.push(GateH(), 0)
circuit.push(GateCX(), 0, 1)
# Measure expectation value of Z operator
circuit.push(ExpectationValue(GateZ()), 0, 0)
conn = MimiqConnection()
conn.connect()
job = conn.submit(circuit, algorithm="statevector")
results = conn.get_results(job)from mimiqcircuits import *
circuit = Circuit()
circuit.push(GateH(), 0)
circuit.push(Depolarizing1(0.01), 0) # 1% depolarizing noise
circuit.push(GateCX(), 0, 1)
circuit.push(AmplitudeDamping(0.05), 0) # 5% amplitude damping
circuit.push(Measure(), range(2), range(2))MIMIQ supports multiple simulation algorithms optimized for different use cases:
auto- Automatically selects the best algorithmstatevector- Full state vector simulation (exact, up to ~30 qubits)mps- Matrix Product State (efficient for certain circuit structures)
# Specify algorithm during execution
job = conn.submit(circuit, algorithm="mps", nsamples=10000)GateH, GateX, GateY, GateZ, GateS, GateT, GateSX, GateTDG, GateSDG, GateID, GateRX, GateRY, GateRZ, GateU, GateP
GateCX, GateCY, GateCZ, GateCH, GateSWAP, GateISWAP, GateDCX, GateECR
GateCCX (Toffoli), GateCSWAP (Fredkin)
GateCU, GateCRX, GateCRY, GateCRZ, GateCP
QFT (Quantum Fourier Transform), PhaseGradient, PolynomialOracle
Measure, MeasureReset, ExpectationValue
Depolarizing, AmplitudeDamping, PhaseDamping, PauliNoise, ThermalNoise
Barrier, Reset, IfStatement (conditional operations)
For Julia users, check out MimiqCircuits.jl - the native Julia implementation with full feature parity.
- mimiqlink-python - Connection and authentication library (included in mimiqcircuits)
- MimiqCircuits.jl - Julia version of this library
MIMIQ Circuits is currently in active development and available for early adopters. To execute circuits on MIMIQ's cloud services, you need an active subscription.
- 🌐 Register on our website to request access
- 📧 Contact us at contact@qperfect.io for organizational subscriptions
- 💬 We value your feedback to improve MIMIQ Circuits
We welcome contributions from the quantum computing community! Whether you're fixing bugs, adding features, improving documentation, or sharing ideas:
- 🐛 Report issues on GitHub Issues
- 💡 Suggest features through GitHub Discussions
- 🔧 Submit pull requests - please read our contributing guidelines first
- 📝 Improve documentation - even small fixes help!
We use uv for dependency management and packaging.
To set up the development environment:
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone the repository
git clone https://github.com/qperfect-io/mimiqcircuits-python.git
cd mimiqcircuits-python
# Install dependencies
uv sync- Run tests:
uv run pytest - Build documentation:
uv run --group docs --extra visualization make -C docs html - Build package:
uv build
- 📧 Email: mimiq.support@qperfect.io
- 🐛 Bug Reports: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 🌐 Website: qperfect.io
Copyright © 2022-2023 University of Strasbourg. All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
<http://www.apache.org/licenses/LICENSE-2.0>Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Made with ❤️ by the QPerfect team