qumulator

qumulator command [options]

qumulator is the command-line client for the Qumulator cloud API, which simulates quantum circuits, spin systems, photonic amplitudes, and molecular properties on standard classical hardware. The local CLI submits jobs via HTTP and prints the result; the heavy compute runs in the cloud (Google Cloud Run, 4 vCPU, 16 GB RAM by default).The simulator targets up to about 1000 qubits for structured circuits without requiring a GPU or quantum hardware. The CLI is bundled with the qumulator-sdk Python package, so installing the SDK exposes both the Python client and the qumulator binary.

--key KEY

Pass the API key directly instead of relying on the environment.

QUMULATOR_API_KEY

Environment variable used by all subcommands when --key is not supplied. Obtain a key with qumulator key.

demo [--willow | --wormhole | --anyon]

Run a built-in demonstration. Without flags, runs a 1000-qubit GHZ circuit. --willow runs a 105-qubit Willow-layout benchmark, --wormhole runs a holographic wormhole simulation, --anyon runs an anyon-braiding computation.

Print instructions for obtaining a free API key.

Submit a QASM file to the API and print the result.

Because circuits are executed in the cloud, circuit data leaves the local machine — do not submit circuits whose structure you consider confidential. Network latency dominates short jobs, so iterating on tiny circuits will be much slower than running them in a local simulator.

Qumulator is published as the qumulator-sdk Python package. It positions itself as a way to run very large but structured quantum simulations on commodity classical hardware via a hosted API, lowering the cost of experimenting with quantum algorithms compared with paid quantum hardware time.

python(1), qiskit(1), pip(1)