SimQΒΆ

Quantum computing at Rust speed

SimQ is a high-performance quantum computing SDK written in Rust β€” designed to be 8–10Γ— faster than Qiskit for variational algorithms, with type-safe circuit construction and first-class Python bindings.

use simq::QuantumCircuit;

fn main() {
    // 3-qubit GHZ state
    let mut qc = QuantumCircuit::new(3);
    qc.h(0).cnot(0, 1).cnot(1, 2);

    let result = qc.simulate_with_shots(1024).unwrap();
    println!("{:?}", result.measurements.unwrap().sorted());
    // [("000", 517), ("111", 507)]
}
import simq

builder = simq.CircuitBuilder(2)
builder.h(0)
builder.cx(0, 1)
circuit = builder.build()

simulator = simq.Simulator(simq.SimulatorConfig(shots=1024))
result = simulator.run(circuit)
print(result.state_vector)

Why SimQ?ΒΆ

⚑ Extreme performance

Sparse state vectors, SIMD-optimized gate kernels, parallel execution, and compile-time gate matrix caching with ~0–5 ns matrix access.

πŸ›‘οΈ Type-safe by construction

Compile-time verification of quantum operations. Invalid circuits are caught before they ever run β€” often before they even compile.

🧠 Memory efficient

Hybrid sparse/dense state representation lets you simulate up to 35–40 qubits on 32 GB of RAM.

πŸ“‰ Built for variational algorithms

Exact expectation values, automatic gradients, and ready-made VQE/QAOA helpers and optimizers.

πŸ”Œ Hardware ready

The same circuit runs on the local simulator or real quantum hardware via the backend abstraction (IBM Quantum and more).

🐍 First-class Python bindings

A familiar, Qiskit-like Python API backed by the full-speed Rust core β€” including noise models and visualization.

Explore the documentationΒΆ

πŸš€ Getting started

Install SimQ and run your first circuit in Rust or Python in under five minutes.

Installation
πŸ“– User guide

Circuits, simulation, observables, VQE/QAOA, the compiler, noise models, and hardware backends.

Building circuits
πŸ§ͺ Examples

Runnable, end-to-end examples: Bell states, teleportation, Hβ‚‚ ground-state VQE, MaxCut QAOA, and more.

Examples
πŸ—οΈ Architecture

How the eight workspace crates fit together β€” for contributors and the curious.

Architecture
🀝 Contributing

Development setup, coding standards, testing, and how to send your first pull request.

Contributing to SimQ
πŸ” API reference

Rust API docs (rustdoc) and the Python binding reference.

Rust API reference